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RVSTF.M AND METHOD FOR CONTROT.UNG USE R INTERFACE 
PROPERTIES WITH DATA 



Rpilated Applications 

5 This utility patent application claims the benefit under 35 United States Code § 

1 19(e) of United States Patent Application No. 10/440,081 filed on May 17, 2003. 

Background of tlie Invention 

The manner in which information is presented to users affects the user's 
abiUty to understand and comprehend the information. On computer displays, it has 

10 become a standard practice to add emphasis to information by using color, font styles, 
and the like. This emphasis allows users to more readily grasp the importance of the 
information. The code handling the presentation of the information (user interface) and 
the code performing the application logic on the information are typically closely 
coupled. For example, the logic assigns user interface properties (e.g., color, font, 

15 position, size) directly with data. Thus, when there is a change to the user interface, the 
logic must typically also change. For example, in the case of a text box, the user 
interface code listens to determine whether text has changed, upon a change, the user 
interface code validates the changed text and then displays the changed text. This tightly 
coupled nature of the user-interface and the logic results in very fragile code. 

20 Maintaining this fragile code is very costly and time consuming. 

Summarv of the Invention 

The present invraition is directed at a system and method for controlling 

the user interface with data. The invention decouples the user interface and the data, 

along with its application logic, by providing a mechanism for associating data to the 

25 user interface. The invention enables user interface designers and application authors 

who write the application logic to work independently. Neither the designers nor the 

authors need to understand the other's code or will impact the other's code development. 

This invention also allows changes to the user interface to be done quite easily. For 
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example, when new and more user-appealing user interface platfomis become available 
or when the user interface designer wishes to change the look of the application, the 
designer does not need to change the application logic. In addition, the mechanism for 
associating data to the user interface is dynamic. This allows any changes in the data to 

5 be automatically reflected in the presentation. In addition, any input from a user via the 
user interface can be automatically update the data. Because the present invention 
allows association of not only data display aspects of the user interface (e.g., text), but 
also visual aspects (e.g., background, font size, and the like), descriptive, visually 
enhancing and flexible presentation of data can be provided. For example, negative 

10 numbers may be displayed in red or an arrow may appear pointing upwards when stock 
prices are increasing. 

Thus, in accordance with the present invention, an application is 
separated into independent parts, a logic portion and a UI portion. The logic portion 
manipulates data values within the application. The UI portion is responsible for the 

15 presentation of the data. A binding specification describes a relationship between the UI 
property and the data value. The binding specification is used by system level code to 
determine the manner in which it is notified when the data value undergoes a change 
and the manner in which it directs the UI portion to reflect the change in the UI 
property. The binding specification identifies a source data item, a path to the data 

20 value in the source data item, a target UI element, and the UI property on the target UI 
element. The binding may be specified using code or markup language. 

Brief Description of the Drawings 

FIGURE 1 illustrates an exemplary computing device that may be used 
in illustrative implementations of the present invention. 
25 FIGURE 2 is a fiinctional block diagram illustrating one embodiment for 

controUing user interface properties with data in accordance with the present invention. 

FIGURE 3 is a logical flow diagram illustrating a process for binding a 
user interface property with a data value in accordance with one embodiment of the 
present invention. 
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FIGURE 4 illustrates several exemplary syntaxes for associating the 
interface properties with the data in accordance with the present invention. 



nf>f ailed Description of the Prefer red Embodiment 

The present invention is directed at a system and method for controlling 
the user interface with data. The invention decouples the user interface and the 
application logic by providing a mechanism for associating the data with the user 
interface. As will be described in detail below, this decoupling of the user interface and 
the data, along with its associated logic, allows different groups of developers to work 
independently on both the user interface and the logic without impacting the code 
development of the other group. In addition, described in detail below, the present 
invention provides a system and mechanism for automatically transferring values from 
data sources to the user interface and vice versa. Throughout the following discussion, 
the term "databinding" refers to the process of associating data values with UI 
properties, transferring and updating the data values, and the like. 
Illustrative Compntipg Environment 

FIGURE 1 illustrates an exemplary computing device that may be used 
in illustrative implementations of the present invention. With reference to FIGURE 1, 
in a very basic configuration, computing device 100 typically includes at least one 
processing unit 102 and system memory 104. Depending on the exact configuration 
and type of computing device 100, system memory 104 may be volatile (such as RAM), 
non-volatile (such as ROM, flash memory, etc.) or some combination of the two. 
System memory 104 typically includes an operating system 105, one or more program 
modules 106, and may include program data 107. Examples of program modules 106 
include a browser application, a finance management appUcation, a word processor, and 
the like. This basic configuration is illustrated in FIGURE 1 by those components 

within dashed line 108 

Computing device 100 may have additional features or functionality. 
For example, computing device 100 may also include additional data storage devices 
(removable and/or non-removable) such as, for example, magnetic disks, optical disks. 



or tape. Such additional storage is illustrated in FIGURE 1 by removable storage 109 
and non-removable storage 110. Computer storage media may include volatile and 
nonvolatile, removable and non-removable media implemented in any method or 
technology for storage of information, such as computer readable instructions, data 

5 structures, program modules, or other data. System memory 104, removable 
storage 109 and non-removable storage 110 are all examples of computer storage 
media. Computer storage media includes, but is not limited to, RAM, ROM, EEPROM, 
flash memory or other memory technology, CD-ROM, digital versatile disks (DVD) or 
other optical storage, magnetic cassettes, magnetic tape, magnetic disk storage or other 

1 0 magnetic storage devices, or any other medium which can be used to store the desired 
information and which can be accessed by computing device 100. Any such computer 
storage media may be part of device 100. Computing device 100 may also have input 
device(s) 112 such as keyboard, mouse, pen, voice input device, touch input device, etc. 
Output device(s) 114 such as a display, speakers, printer, etc. may also be included. 

15 These devices are well know in the art and need not be discussed at length here. 

Computing device 100 may also contain communication connections 116 
that allow the device 100 to communicate with other computing devices 118, such as 
over a network. Communication connections 116 are one example of communication 
media. Communication media may typically be embodied by computer readable 

20 instructions, data structures, program modules, or other data in a modulated data signal, 
such as a carrier wave or other transport mechanism, and includes any information 
deUvery media. The term "modulated data signal" means a signal that has one or more 
of its characteristics set or changed in such a manner as to encode information in the 
signal. By way of example, and not limitation, conmiunication media includes wired 

25 media such as a wired network or direct-wired connection, and wireless media such as 
acoustic, RF, infrared and other wireless media. The term computer readable media as 
used herein includes both storage media and commimication media. 
Illustrative Implementation 

FIGURE 2 is a functional block diagram illustrating one embodiment of 

30 a system 200 for controUmg user interface properties with data in accordance with the 



present invention. The system 200 includes an application 202, a platform 220, and a 
data source 230. Application 202 may be one of applications 106 on computing device 
100 shown in FIGURE 1. The application 202 includes code (hereinafter referred to as 
logic 204) for manipulating a data value (e.g., source data value 238). In general, the 

5 logic 204 performs validation on data values and updates the data values. Data value 
(e.g., data value 238) represents the content of a property (i.e., a data source property) 
of a data item (e.g., data item 232). The data item 232 is located within a data source 
(e.g., data source 230). Each data source 230 may include several data items, each data 
item has one or more properties, in which the source data value is stored. Logic 203 

10 may manipulate data values fix)m multiple data sources. The data sources may include 
an XML document, an object, a dataset, and the like. As will be described in greater 
detail below, each property of the data item may be used to control the user interface 

(UI). 

The application 202 also includes code (hereinafter referred to as user 

15 interface 206) for presenting information. The user interface 206 includes several user 
interface elements (e.g., user interface element 208). Each user interface element 208 
includes one or more properties (e.g., UI properties 210 and 212), such as for displayed 
text, color, font, position, size, and the like. Then, as described in detail later, these UI 
properties 210 and 212 are associated with one or more of the data values 238 and 242 

20 in accordance with the present invention, hi general, the association occurs via a 
binding engine 224 within the platform 220. The platform 220 represents a system 
layer of services, such as an operating system, a virtual engine, and the like. The 
platform 220 also includes a property engine 222 that is responsible for maintaining 
hierarchical information pertaining to the data values 234 and 242 and for updating the 

25 associated properties with data values. Even though binding engine 224 and property 
engine 222 are shown as separate components, one skilled in the art will appreciate that 
the functionality provided by each may be included within one component without 
departing fi-om the present invaition. 

The association (i.e, bindings) of the data values 238 and 242 to their UI 

30 properties 210 and 212 is represented in FIGURE 2 by dashed lines from the data value 
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to the UI property (hereinafter referred to as bindings 226 and 228). During the 
following discussion, the term "data value" may be used interchangeably with the term 
"source data value". Similarly, the term UI property may be used interchangeably with 
the term "target property". These bindings 226 and 228 allow dynamic properties (i.e., 

5 target properties) to be automatically set from data values (i.e., source data values), such 
as from properties of arbitrary objects. These bindings may be dynamic so that the 
bound target property automatically updates to reflect changes in the source data value. 

In order to provide this automatic updating capability, the present 
invention further provides a notification mechanism (e.g., represented in FIGURE 2 by 

10 notifiers 236 and 240 and arrows from the notifiers to platform 220). Each data item 
232 and 234 has a corresponding notifier 236 and 240, respectively. The notification 
mechanism is responsible for informing the system that the source data value has 
changed and that the data value can be propagated to the target property (i.e., UI 
property). 

1 5 When a binding 226 and 228 is created, such as through markup, code, 

and the like, the binding engine 224 creates a binding object (e.g., binding objects 250 
and 252) associated with the binding. For example, binding object 252 may represent 
binding 228 within the binding engine 224. Each binding object includes several 
properties (e.g., binding properties 260-272). Each of these binding properties 260-272 

20 may be set programmatically. The following discussion describes each of these 
properties and FIGURE 4 illustrates exemplary code for activating a binding that 
specifies some of these properties. 

One of the binding properties (hereinafter referred to as path 260) 
identifies the manner in which to locate the source data value (via the source object). 

25 The path 260 may refer to a property, sub-property or indexer on the source object, a 
column in ADO (ActiveX Data Objects), an XPath on XML, and the like. 
Alternatively, the path may refer to a reflection or ADO path. 

Another one of the binding properties (hereinafter referred to as bindtype 
262 defines a type for the binding 226 and 228. In one embodiment, the bindtype 

30 includes oneWay, two Way, and oneTime. As an illustration, binding 226 represents a 
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twoWay binding and binding 228 represent a oneWay binding. One of these binding 
types is set as a default. In one embodiment, two Way binding is set as the default 
binding type. 

When the bindtype 262 is specified as oneWay, this signals the binding 
5 engine 224 to update the target property (e.g., UI property 210) every time a change 
occurs in the associated source data value. OneWay bindtype is useful for binding a 
data value to a non-editable UI property, such as text color, text background, and the 
like. Using oneWay bindtype avoids the overhead of a twoWay bindtype, described 
below. This decrease in overhead is most noticeable when Ustening to changes in UI 
1 0 properties regarding layout content. For these UI properties, the dynamic properties of 
each of the children of the UI property must typically be Ustened to for changes to the 
UI property. OneWay bindtype may also be useful when changes in the UI property are 
just for showing other presentation detail. 

When the bindtype 262 is specified as twoWay, this signals the binding 
1 5 aigine 224 to update the target property every time a change occurs in the source data 
value and vice versa. TwoWay binding is especially helpfiil when binding data to an 
edit box where any changes made by the user in the edit box need to be propagated to 
the source data value. Another scenario for twoWay binding is when anothw 
application is responsible for the source data field and those changes are reflected in an 
20 edit box. 

When the bindtype 262 is specified as oneTime, this signals the binding 
engine 224 to initialize the target property once and then leave it untouched, even if the 
associated source data value is changed. The oneTime bindtype is useful when some 
target property needs to be initialized with some value fi-om a source field and the data 
25 context is not known in advance. In addition, oneTime bindtype is usefiil for read-only 
use of unchanging source data values. If the data source does not support the property 
notification mechanism of the present invention (e.g., IPropertyChange interface), the 
target property that is specified as oneWay will be updated similarly as if the binding 
specified oneTime as the bindtype. 
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Another one of the binding properties (hereinafter referred to as 
updatetype 264) defines a type of update for the case in which bindtype 262 specifies 
twoWay. Typically, twoWay bindings listen for changes in the target property and 
propagate those changes back to the source data value. This process is referred to as 
updating the source. Normally, it is desirable to update whenever the target property 
changes. However, in certain situations, updating after every keystroke wastes cycles 
and denies the user the opportunity for correcting typing errors and the like. Updatetype 
264 allows the user to specify when the updates should occur. In one embodiment, 
updatetype 264 may specify Immediate, OnLostFocus, and Explicit. Specifying 
Immediate will signal the binding engine to update the source data value after every 
change to the target property. Specifying OnLostFocus will signal the binding engine to 
update the source data value after the target element has lost keyboard focus. 
Specifying ExpUcit will signal the binding engine to update the source data value only 
when the application explicitly requests an update. Typically, this explicit request is 
performed via a method. Even though this method may be called for any setting of 
updatetype 264, the method is usefiil when the updatetype is set to ExpUcit. Exemplary 
methods are shown below: 

Binding.GetBinding(myElement, myProperty).UpdateO; and 
MyElement.GetBinding(myProperty).UpdateO 

Another one of the binding properties (hereinafter referred to as source 
266) identifies the source data item for the binding. Briefly, illustrated in FIGURE 4 
and described in conjunction therewith, the source 266 may be set programmatically or 
with markup. Programmatically, the developer provides an objectref to the object that 
the binding should use as the source data item. Briefly, described in detail in 
conjunction with FIGURE 4, in markup, there are various methods for setting the 
source property. 

Anotiier one of the binding properties (hereinafter referred to as 
transformer 268) accepts a class reference. The class reference may be specified using 
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<Nainespace>. <Class>, <Assembly>. The class reference that is specified is invoked 
by the binding engine 224 to transform the source data value into a format accepted by 
the target property. A method within the class reference invokes this transformation, 
represented as transform 244 in FIGURE 2. The class reference may also specify an 
5 inverse transform (not shown) for transforming the target property to a format accepted 
by the source data value. Hie transform 244 may supply UI semantics or be a custom 
type converter. 

Another one of the binding properties (hereinafter referred to as culture 
270) defines the mamier in which the source data value should be handled before/after 
10 transforming the source data value. Culture 270 operates in conjunction with 
transformer 268 to allow developers to specify rules for transforming source data 
values. For example, the culture may specify a specific format for numbers, dates, and 
the Uke. In one embodiment, the culture 270 accepts a value of a type CultureMo. The 
developer has the option of using the rules specified by the culture 270 when 

1 5 implementing the transform. 

Another one of the binding properties (hereinafter referred to as 

bindflags 272) provides a mechanism for receiving events signaling the transfer of data. 

Because the above described method for data binding is asynchronous, the bindflags 

272 allow a developer to know when the target has been updated with the new value. In 
20 order to use this mechanism, the bindflags 272 is set to "NotifyOnTransfer". A handler 

is then registered for the event using any customary ways. One exemplary use for this 

mechanism is as follows: 



Public static void mainQ 
25 { 

//Add a handler 

elem.AddAttachedHandler(Binding.DataTranferEvent. 

newDataTranferEventHandler(OnDataTransfer), 
RoutedEventArgs.EventStage.Direct); 

30 
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//Event handler 

private static void OnDataTransfer(Element e, DataTransferEventArgs args) 
{ 

DynamicProperty DP=args.DP; 

v-e.GetValue(DP); 

DoSomething(v); 

} 

source.field="new value"; 

}. 

Another exemplary method is: 

void AddDataTransferHandler(UIElement elem) 

{ 

//Add a handler 

elem.AddHandler(Binding.DataTransferEventID, 

new DataTransferEventHandler(OnDataTransfer) ); 

} 

//Event handler 

private void OnDataTransfer(object sender, DataTransferEventArgs 

args) 

{ 

DependencyProperty dp = args.Property; 
UIElement e = sender as UIElement; 
object V = e.GetValue(dp); 
DoSomething(v); 

}. 

As shown in the above example code, once the OnDataTransfer event has been 
triggered, the developer knows that the dynamic property has been updated. Thus, the 
developer may then use the target value for further processing. 
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FIGURE 3 is a logical flow diagram illustrating a binding mechanism in 
accordance with one embodiment of the present invention. In overview, the binding 
mechanism performs actions to set-up the binding (blocks 302-306) and then performs 
actions (blocks 310-338) related to changes in the target property or source data value 
as specified in the binding. Processing continues at block 302. 

At block 302, a binding object is created based on the arguments 
specified during the creation. Briefly, each property (i.e., properties 260-272 shown in 
FIGURE 2) for the binding object 252 may be specified as an argument during the 
creation. The binding may be created flirough markup, programmatically, and the like. 
FIGURE 4 illustrates exemplary syntaxes for creating a binding and specifying the 
properties 260-272. Each manner of creation specifies a source data item, a path to the 
data value in the source data item, a target UI element, and a target dynamic property on 
the UI element. While not shown in the present flow diagram, the properties of the 
binding object may also be modified dynamically during runtime, such as through the 
use of application programming interfaces (APIs). Processing proceeds to block 306. 

At block 304, the binding is activated. In one embodiment, the binding 
may be activated automatically once tiie binding engine notices that there is sufficient 
context for the binding, such as having the source object exist, the target element ready 
to display, and the like. The binding engine is responsible for recognizing activation of 
the binding. Processing continues at block 304. 

At block 306, a value for the specified source property is found. In one 
embodiment, reflection is used to find the value. Reflection is a general mechanism that 
allows a caller to obtain information about a requested object. The information includes 
objects that are supported, public properties, and the like. In another embodiment, 
when data item is a collection, the binding engine performs a number of heuristics to 
determine whether the to use the current record or the data object (collection) itself A 
first hexuistic is applied when the binding refers to a property or indexer. In this 
situation, the corresponding property or indexer on the collection object is used if such a 
property or indexer exists. Alternatively, the current record of tiie collection is used as 
the data item. Another heuristic is applied when no property or indexer exists. In this 
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situation, the collection object is used for the target property as long as the collection 
object is valid. Otherwise, the current record is used. Before continuing to block 308, a 
transform is applied to the value if the binding specifies a tiransform (block 307). The 
application of a transform is described in detail in conjunction witii block 316 below. 

5 Processing continues at block 308. 

At block 308, the value that was found is assigned to the target property. 
m one embodiment, a property engine tiiat is responsible for maintaining the hierarchy 
of the properties may assign the value. In another embodiment, a ti:ansform specified 
during creation of the binding may be invoked to transform the value before assigning 

10 the value to the target property. In a fiirther refinement, tiie property engine may mark 
the property as having a new value. Once blocks 302-308 have been performed, tiie 
binding engine is ready for updating target properties and source data values as needed. 
In general, the binding mechanism is asynchronous. 

Therefore, from block 308, processing continues through two 

1 5 asynchronous paths. A first path (blocks 310-318) is associated with updating the target 
property and a second path (blocks 330-338) is associated with updating the source data 
value. Each ofthese paths is described below. First, the patii responsible for updating 

the target property is discussed. 

At decision block 310, the binding engine detennines whether the 
20 binding associated with the source data value and the target property has specified the 
bindtype as oneTime. If the bindtype is oneTime, processing is complete for this 
binding and proceeds to the end. One skilled in the art will recognize, that if the 
bindtype is oneTime, the binding engine does not listen for source property change 
events. Thus, in acUial practice, the logic within the binding engine does not 
25 necessarily perfonn a check as shown in block 310. In addition, if the data item does 
not implement PropertyChange, processing is complete. If, however, tiie bindtype is 
not oneTime, processing continues at block 312. 

At block 312, the binding engine listens for notifications associated witii 
tiie bindings. Because databinding does not directly update the target with the source 
30 data value, the present invention hnplements a notification mechanism. Notification 
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mechanisms, such as property change notifications and collection view 
"CurrentChanged" notifications and the Uke, are known in the art and need not be 
discussed at length here. Different actions cause a notification, such as a data value 
change, a page navigation, shutdown, change in record of interest in a data collection, 
5 and the like. Because the present invention triggers an update upon a change in the 
record of interest in a data collection, the present invention provides a convenient 
mechanism for fiirther de-coupling the user interface and tiie logic. For example, in 
accordance witii the present invention, tiie developer only needs to write code in the 
logic to specify how to change to the next record of interest in a data collection. Once 
10 the change occurs, the binding engine, in accordance with the present invention, will 
update the user interface according to the bindings akeady specified. As mentioned 
before, this de-coupling of the user interface and the logic provides a more robust and 
more easily maintained application tiian when the user interface and logic are 
intertwined. 

1 5 The following code is one exemplary implementation for the notification 

mechanism. While the exemplary code written below is written in C#, tiiose skilled in 
the art will appreciate tiiat various languages and syntax may be used to implement tiie 
notification mechanism. For any such implementation, an interface is defined for use 
by each data item. Each data item inherits this interface in order to implement dynamic 

20 updating. 

Public interface IPropertyChange 
{ 

event PropertyChangedEventHandler PropertyChanged; 

25 }. 



Next, an event handler and its arguments are defined. 



30 



public delegate void PropertyChangedEventHandler(object sender, 
FropertyChangedEventArgs e); 
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public class PropertyChangedEventArgs : EventArgs 
{ 

public virtual string PropertyName { get ;} 

5 }. 

The class PropertyChangedEventArgs includes one read-only property named 
PropertyName having a type string. The PropertyName property contains a name for 
the property which has changed. Each source data item then implements this interface 
1 0 by calling the PropertyChanged delegate whenever one of its properties has changed. 
The following is an illustrative example for implementing a source object (e.g., data 
item 232) in accordance with the embodiment for the notification mechanism. 

public class myClass : IPropertyChange 
15 { 

private string foo = "Hello World"; 

public string Foo 

{ 

get { return foo; } 
20 set { if(foo != value) 

{ 

foo = value; 

NotifyPropertyChanged("foo"); 

} 

25 } 

public event PropertyChangedEventHandler Property Changed; 
private void NotifyPropertyChanged(string propName) 

{ 
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PiopertyChanged(this, new 

PropertyChangedEventArgs(propName)); 

} 

}• 

As shown above in the exemplary code, the 'set' method for the Too' property 
determines whether a new value is different than the old value. If the values differ, the 
handler is called. In another refinement, an empty string may be passed in the 
arguments to signal that all bindings to each of the data item's data values should be 
updated. This may occur when the source object is not certain about which properties 
have changed and would like each binding updated. Once the binding engine receives a 
notification that the data source value has changed, processing continues at decision 
block 314. 

At decision block 314, a determination is made whether the binding 
associated with the source data value that changed specified a transform for the binding. 
If the binding does not specify a transform, processing continues at block 318. 
However, if the binding does specify a transform, processing continues at block 316. 

At block 316, the transform that is specified in the binding is performed. 
In one embodiment, transformer 268 is an object as described below: 

Public interface IDataTransformer 
{ 

object Transform(object o, DependencyProperty dp, Culturelnfo culture) ; 
object InverseTransform(object o, PropertyMo info, Culturelnfo culture) ; 

}• 

For the above interface, o denotes the source value, dp denotes the target 
dynamic property, and culture denotes the culture to use during the transformation. The 
TransformO method transforms the source value o into an object suitable for assigranent 
to the property denoted by dp. The TransformQ method is called when propagating a 
data value from the source of a binding to the target property. If the TransformQ 
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method returns a value of null, the binding engine is signaled to stop propagating 
values. 

The transformer may also be used for controlling other UI properties, 
such as width, height, font, positioning(x,y), and the like based on the associated source 
data value specified in the binding. Transformers provide the ability to perform logic on 
the data value in order to show the data in several ways. In a further refinement, a 
culture may be applied during the transform as specified in the binding. Processing 

continues at block 318. 

At block 318, the target property is updated. In one embodiment, the 
property engine assigns the value to the target property. In addition, the target property 
may be marked as having a new value. Processing may then continue to block 312 and 
Usten for the next property change notification associated with the binding. Once the 
application ends or the binding is otherwise terminated, processing proceeds to the end. 

As mentioned above, fi-om block 308, processing may continue through a 
second path. Thus, from block 308, processing continues at decision block 330. As 
mentioned above regarding decision block 310, the logic within the binding engine may 
not necessarily perform a check of the bindtype during decision block 310, but rather, 
because the binding engine was not told to listen for notifications when the binding was 
created, the process does not flow through the second path. However, for clarity in 
describing the flow, a decision block reflecting the bindtype is shown. Therefore, at 
decision block 330, a determination is made whether the binding specified two Way as 
the bindtype. As discussed earUer, twoWay allows changes in the target property to be 
propagated to the source data value. If the binding does not specify twoWay as the 
bindtype, processing proceeds to the end. However, if the binding does specify 
twoWay as the bindtype, processing continues at block 332. 

At block 332, the binding engine will recognize certain actions that 
trigger an update to the source data value. Once a trigger occurs, processing continues 

at decision block 334. 

At decision block 334, a determination is made whether the binding 
specifies an inverse transform for the binding. If the binding does not specify an 
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inverse transform, processing continues at block 338. However, if the binding does 
specify an inverse transform, processing continues at block 336. 

At block 336, the inverse transform is applied to the source property. In 
one embodiment, the inverse transformer is an object as described above in reference to 
the Public interface IDataTransformer. 

For the above interface, o denotes the source value, culture denotes the 
culture to use during the transformation, and info denotes the Propertylnfo of the target 
property. The InverseTransformQ method transforms the source value o into an object 
suitable for assignment to a property of type info. This method is called when 
propagating a value from the target of a binding to the source. If the 
InverseTransformQ method returns a value of null, the binding engine does not 
propagate a value. Once the InverseTransform is performed, processing continues at 
block 338. 

At block 338, the source property is updated according to the udpatetype. 
As described above, the updatetype may be immediate, on loss of focus, expUcit, and 
others. Once the source property is updated, processing proceeds to the end. 

FIGURE 4 illustrates several exemplary means for creating a binding. 
Creation means 400-410 creates the binding through markup. Creation means 410 
creates the binding through code. The illustrative means shown in FIGURE 4 are not 
exhaustive. Other means (syntax) may be used without departing from the scope of the 
present invention. 

Creation means 400 includes a DataContext name/value pair 
(hereinafter referred to as DataContext 422) and Id name/value pair (hereinafter referred 
to as Id 420) for an element 424. Because creation means 400 also includes 
DataContext 422, Id 420 is unnecessary. Id 420 is needed when it is desirable to refer 
to an explicit source, such as using ElementSource in markup or an IdObjectRef witiiin 
code. Both of these uses are described below. DataContext 422 is a dynamic property 
defined on an element (e.g., element 424). The value associated with DataContext 422 
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represents the default source data item and is an inheritable property. The binding 
engine queries DataContext 422 and utilizes DataContext 422 when creating a binding 
for element 424 and descendent elements (e.g., Button element 426). The binding 
engine also listens for changes to DataContext 422, which triggers an update 
accordingly. Thus, while not required, DataContext 422 provides a convenient 
mechanism for estabUshing scope for all properties bound to a common data item. 
Descendant elements may have their own DataContext, which will take precedence over 
the DataContext 422 of the parent element. A binding may override DataContext 422 
by supplying a non-null Source, described below in conjunction with creation means 
402. 

Button element 426 is illustrated with a target property (e.g., 
Button.Content 428). In accordance with the present invention, upon encountering 
"Data:Bind", the binding engine recognizes that a binding is being specified. 
Name/value pairs that follow, set the binding properties 260-272 as specified in 
FIGURE 2. One skilled in the art will appreciate that the terms "Data:Bind" to signal a 
binding is an arbitrary term and any number of terms may have been used without 
departing from the present invention. Creation means 400 represents a verbose markup 
format. 

Creation means 402 represents a compact markup format. The UI 
property (e.g.. Button Text) is represented in a more compact fashion. Again, 
"Data:Bind" is used as a signal to the binding engine that what follows is a binding. 
Also, the name/value pairs following DatarBind correspond to the desired properties 
260-272 described earUer for the bindmg object 250 in HGURE 2. For example, 
ElementSource name/value pair (hereinafter referred to as ElementSource 434) 

corresponds to source 266. 

In markup, there are two methods for setting the source property: 
ElementSource and DataSource. If neither of these is used, the default value for source 
is null which signals the binding engine, upon creation, to get the value of the element's 
DataContext propaty and use the value as the source object. 
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When a creation means (e.g., creation means 402) specifies an 
ElementSource, the binding engine finds the element whose ID is specified by the 
ElementSource property. That element's DataContext is then used as the source object. 
Relative pathnames, such as /Parent/Parent and /Previous/Previous, may be used to 
5 specify the datasource. When the binding engine encounters /Parent, it looks for the 
element parent to the current element in terms of object hierarchy. For example, if the 
element is a customer order, specifying /Parent may signal the binding engine to look 
for the element which corresponds to a customer for the current order. Specifying 
/Parent is useful in nested repeater cases in which it is desirable to use values from an 
1 0 outer repeater in the scope of an inner repeater. Specifying /Previous signals the 
binding engine to look for the element previous to the current element under the 
Repeater. Specifying /Previous is useful when it is desirable to access the current-n 
item in addition to the current item, such as in line graphs and the like. Successive 
/Previous and /Parent may be used in accordance with the present invention. 
15 In another embodiment, markup may specify a DataSource. When a 

DataSource is specified, the binding engine accepts the resource id of a Resource. If the 
Resource exposes a data pix>perty. then the binding engine will set the Source of the 
binding to the object returned by the data property of the DataSource resource. 
Otherwise, the binding engine will set the source of the binding to the resource object 
20 itself. 

Those skilled in the art will appreciate that there are various ways in 
which properties 260-272 may be expressed using a markup language, and therefore, 
the manner in which each of these other properties may be expressed using a markup 
language is not explained in fiarther detail herein. 

25 The next three creation means 404-410 provide illustrative examples on 

the type of items that the present invention may bind. Creation means 404 illustrates 
support of binding to sub-properties and indexers. Creation means 404 corresponds to a 
binding written in C# as di.a.b[3].c, wherein di is the relevant data item. As long as the 
data item, the class that implements di.a, the class that implements di.a.b, and the class 

30 that implements di.a.b[3].c all support the notification mechanism of the present 
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invention (e.g., IPropertyChange) and notify when their properties change, the binding 
specified using creation means 404 wiU cause the binding engine to automatically 
update the bound property (e.g., the target property) to reflect changes in the source data 
value. 

5 Creation means 406 illustrates support of binding to a data collection. 

The binding engine will automatically use the current record of the collection at each 
level (wherein a, b, and c represent different levels). For example, if di.a has a type 
IDataCoUection, the bindmg uses the current record of the collection to fetch the "b" 
property. Thus, the binding engine automatically updates values associated with a data 

1 0 collection whenever the current record is changed. 

Creation means 408 illustrates support of binding to XML node. The 
path 260 to the value is supplied using an XPath expression, such as 
■VCustomer/Order[@OrderID=10]/Amount)", as shown in FIGURE 4. Creation means 
410 illustrates support of binding to ADO data tables. For this implementation, the path 

1 5 260 to the value is supplied as a field name for a particular row, such as "OrderlD", as 

shown in FIGURE 4. 

Creation means 410 creates the bindings programmatically. The 
developer provides an objectref to the object that the binding should use as the source 
data item. The program statements shown in creation means 412 create a binding with 
20 the same behavior as the one illustrated by creation means 410. The SetBinding method 
has a number of more elaborate variants by which the programmer can specify any of 
the binding properties discussed above. The simple example above uses the button's 
DataContext as the source object. The following program statements create a one-way 
binding that uses a specific object (known at runtime) as the source: 
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Object source = . . . some arbitrary object . . . ; 

Binding.SetBinding(myButton, Element.BackgroundProperty, "Color", 
BindType,OneWay, new ExpUcitObjectRef(source)); 
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The following exemplary program statements may also be used: 
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myButton.SetBinding(Button.BackgroundProperty. "Color". BindType.OneWay. 

new ExplicitObjectRef(source)); 

The following example code displays one implementation for controllmg 

a user interface property with data via the binding mechanism of the present invention. 
In this example, the data value (e.g.. mylnteger) and the UI property (e.g., TextContent) 
activated as a binding. In addition, a transform (e.g., MyTranformer) is specified 



are 

for this binding, 
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<TestTextContent="*Data:Bind(Path=myInteger)" 

Foreground="*Data:Bind(Path=Myhiteger;Transformer=MyTransfonner)"/> 



pubUc class MyTransformer : mataTransformer 

^ public object Transform(object o, DependencyProperty dp, Culturehifo 

15 culture) 

{ 

if ((int)o <0) retum Red; 
else retum Black; 

} 

20 

public object hiverseTransform(object o, Propertylnfo info, Culturelnfo 

culture) 

{ 

retum null; 

25 } 
}• 

The following exemplary code may also be used: 
<Element.Resources> 
<MyTransformer def:Name="xform"/> 
30 <Element.Resources> 
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<SimpleText Text="*Bind(Path=myInteger)" 

Foreground="*Bind(Path=myInteger; Transformer={xform})" l> 

Exemplary APIs 
System. Windows.Data 

This namespace includes classes and interfaces used for binding 
properties to data sources, data source classes, data-specific implementations of 
collections and views, and handling exceptions in data entry. The following list the 
members exposed by the System. Windows.Data namespace. 

Classes 

ArrayListCoUectionView encapsulates the collection view support for 
the ArrayListDataCoUection collection class. This class cannot be inherited. 

AirayListDataCoUection provides a built-in implementation of an array- 
Ust data collection with an underlying collection-view interface. It also implements 
ICoUectionChange to provide notification when items are added, items are removed, or 
the whole collection is refreshed. 

Bind Represents a bind declaration object, used to manage bindings 
between a dynamic property user interface (UI) and source data. 

Binding Provides access to the single run-time instance of a binding. 

This class cannot be inherited. 

BindingListCoUectionView - A collection view class used for 

Microsoft® ActiveX® Data Objects (ADO) data views. 

CoUectionContainer - Objects of this class hold an existing collection 
structure— for example, an ArrayListDataCoUection or some other DataSet inside the 
ItemCoUection. 

ContextAffinityCollectionView - hnplements a collection view that 
includes checks for context affinity. 

22 



DataContextObjectRef - Supports object references to elements whose 
DataContext is being used as the source for a binding. Tliis class cannot be inherited. 

DataSourceObjectRef - Supports object references to data sources. This 

class cannot be inherited. 
5 DataTransferEventArgs - Encapsulates arguments for data transfer 

events. The events are routed events that must typically be handled specifically by a 

designated handler based on the DataTransferEventHandler delegate. 

ElementObjectRef - Represents an object reference to an element, with 

the object being specified by its element ID. This class cannot be inherited. 
1 Q ExpUcitObjectRef - Represents an object reference to an explicit object. 

This class cannot be inherited. 

ListCoUectionView - Implements a collection view for collections based 

on IList. 

ObjectDataSource - Serves as a data source for data binding. Bindable 
1 5 data items can be specified as common language runtime types. 

ObjectRef - The abstract class that is used as the parent class of 
DataContextObjectRef, ElementObjectRef, ExpUcitObjectRef, and TypeObjectRef 

ParameterCoUection - Objects of this class hold the collection of named 
parameters (with their corresponding values) for an SqlDataSource. 
20 QueryCommand - This class represents a single select statement to be 

submitted to the database. 

RefreshCompletedEventArgs - Encapsulates the arguments passed either 
in the RefreshCompleted event of ObjectDataSource, or in the RefireshCompleted event 
ofXmlDataSource. 

25 SqlCommandList - A Ust of sql commands and the names of the tables 

that they should be used to fill. 

SqlDataSource - SqlDataSource gets data fi:om a Microsoft SQL Server 

for use in databinding. 

TransfomerSource - Allows resource reference to a transformer class 

30 that is defmed as code-behind in the current application. 
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TypeObjectRef - Supports object reference by type. This class cannot be 

inherited. 

WinFSDataSource - The WinFSDataSouice facilitates databinding of 

data stored in WinFS with Avalon applications 

XmlDataNamespaceManager - XmlDataNamespaceManager Class Used 

to declare namespaces to be used in Xml data binding XPath queries 

XmlDataSource - Serves as a data source for data binding to Extensible 

Markup Language (XML) content nodes. 

XmlNamespace - Declares an individual namespace within an XML data 

10 source. 

Interfaces 

IContains - Used to create classes that declare filtering criteria for 
collection views. 

15 IDataSource - Supports creation of data source objects. Data source 

objects are used for common representation of data for data binding. 

IDataTransformer - Provides methods that enable client-side 
transformation of bound data. 

20 Enumerations 

BindFlags - Describes special properties of a binding. 
BindStatus - Status of a Binding. 

BindType - Describes how changes in data values will transfer to and 
from source properties and target properties of a binding. 
25 SqlDataSourceMode - The enumeration of the possible modes that 

SqlDataSource can have. The mode determines what sort of data is returned when the 
application retrieves the value fi-om the Data property. 

UpdateType - Specifies when updates to the data source (target-to-source 
data transfer) should occur in a binding. Setting these values will only be relevant if a 
30 binding's BindType is set to TwoWay (or defaults to TwoWay). 
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Delegates 

DataChangedEventHandler - Represents the method that handles the 
DataChanged event raised by data sources that implement IDataSource. 

DataTransferEventHandler - Represents the method that handles a data 

transfer event raised by Binding. 

RefreshCompletedEventHandler - Represents the method that handles 
the ObjectDataSource.RefreshCompleted and XmlDataSource.RefreshCompleted 
events. 

class sealed System. Windows.Data.ArrayListCollectionView : ListCoUectionView : 
ContextAffinityCoUectionView : CoUectionView : Object Implements: lEnumerable 
ICoUectionChange ICurrentltem IComparer 
{ 

protected virtual Void OnCollectionChanged(Object sender, 
CoUectionChangeEventArgs args) 
protected virtual IList PrepareLocalArray(IList hst) 

} 

class System. Windows.Data.ArrayListDataCollection : ArrayList : Object Implements: 
IList ICoUection lEnumerable ICloneable ICoUectionChange ICoUectionViewFactory 

{ 

pubhc virtual hit32 Add(Object newltem) 
pubUc virtual Void AddRange(ICollection range) 
public virtual Void ClearQ 
public virtual sealed CoUectionView CreateViewQ 
pubhc virtual Void Insert(hit32 index, Object insertltem) 
pubUc virtual Void LisertRange(Int32 index, ICoUection c) 
pubhc virtual Void Remove(Object removeltem) 
public virtual Void RemoveAt(Int32 index) 
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public virtual Void RemoveRange(Int32 index, Int32 count) 
public virtual Void ReverseQ 

public virtual Void SetRange(Int32 index, ICoUection c) 
public virtual Void SortQ 

5 } 

Represents a bind declaration object, used to manage bindings between a 
dynamic property user interface (UI) and source data. 

BeginDefer - Begins a defer cycle. Defer cycles are used to batch 
10 multiple bind declaration changes and improve performance. 

Bind - Initializes a new instance of the Bind class. The Bind object 
represents the bind declaration of a binding. 

EndDefer - Ends a defer cycle and updates the binding with the 
accumulated declaration changes made to the Bind declaration object. 
1 5 Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

20 GetHashCode - Serves as a hash function for a particular type, suitable 

for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
IApplyValue.Apply - AppUes the value to a property of an element. In 
25 this class, this method is not intended to be called directly. 

MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 
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ToString - Returns a String that represents the current Object. Inherited 

from Object. 

Properties 

BindFlags - Gets or sets the flags that describe the binding. 
BindType - Gets or sets the type of the binding. 
Culture - Gets or sets the Culturelnfo to use in a transformer associated 
with the binding (which may be the default transformer, if the Transformer property is 

not specifically set on the Bind object). 

DataContextSource - Gets or sets the reference to another element that 

this element should use as source for the binding's data context. 

DataSource - Gets or sets the object reference to the data source of the 

binding. 

ElementSource - Gets or sets a string naming the identifier (ID) of 
another element in the application that should be used as the data source for the binding. 

ObjectSource - Gets or sets the object reference to the data source of the 

binding. 

Path - Gets or sets the description or name of the desired data property 
in the source, or an XPath query to desired data if the binding is to Extensible Markup 

Language (XML) data. 

Source - Gets or sets the source object of the binding, as a special object 

reference object. 

Transformer - Gets or sets a reference to the transformer to apply to the 
bound property. 

UpdateType - Gets or sets the update type used in this bind declaration. 

The Bind class is used to create and maintain the bind declaration. The 
declaration establishes the various base properties required for a typical binding, such as 
the source property, the type of the binding's update relationship of source vs. bound 
data, and other characteristics of a particular binding. 
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A Bind object's properties can be manipulated after the binding has been 
established, using C# calls to properties. 

Properties of the Bind class closely parallel the *Bind syntax used for 
establishing a bind declaration in a particular markup language (named "XAML"). 

Bind to a Property 



This example describes how to bind to a property using "XAML". 



All bindings include the following: 

Target element 

Target dynamic property 

Source object 

Source property 



In this case, the BoundColor property is the source property, myData is 
the source object. Button is the target element, and Background is the target property. 



<DockPanel ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr' 
xmhis:def="Definition" 
> 

<DockPanel.Resources> 
<ObjectDataSource def:Name="myDataSource" 
TypeName="WCPSample.myData,BindNonTextPropertySample"/> 
</DockPanel.Resources> 
<DockPanel> 
<DockPanel.DataContext> 
<Bind DataSource=" {myDataSource} "/> 
</DockPanel.DataContext> 
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<ButtonBackground="*Bind(Path=Boun(lColor;BindType=OneWay)" 

Width="200" Height="30">I am RED!<yButton> 
<;/DockPanel> 
</DockPanel> 

Create a Binding 

This example shows how to create a binding in C#. To do this, you 
attach the binding object for the SampleText source property in data to the Text 
property of the SimpleText element, mytext. 

When calling the Bind constructor, you can pass the source object 
through the ExplicitObjectRef constructor to get an ObjectRef object. There are many 
possible signatures both for the Bind constructor and for the SetBinding convenience 
method, and it is even possible to create the entire binding with the convenience method 
without calling tiie Bind constructor at all, but this example splits the operation into the 
constructor piece and then the specific setting of that bind declaration on an individual 
property of an element. If you do this in two steps, then the bind declaration created as 
the intermediate can be reused for binding to more than one element in your appUcation. 

public void CreateBindingQ 

{ 

myDataObject = new myData(System.DateTime.Now); 
myBindDef = new Bind("MyDataProperty", BindType.TwoWay, new 
ExplicitObjectRef(myDataObject)); 

mytext.SetBinding(SimpleText.TextProperty, myBindDef); 

} 

class sealed System.Windows.Data.Bind : Object Implements: 

lApplyValue 
{ 
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public Void BeginDeferQ 

public Void EndDeferQ 

public BindFlags get_BindFlagsO 

public BindType get_BindTypeO 

public Culturelnfo get CultureQ 

public String get_DataContextSourceO 

public Object get_DataSourceO 

public String get_ElementSourceO 

public Object get_ObjectSourceO 

public String get_PathO 

public ObjectRef get_SourceO 

public IDataTransfonner getTransformerO 

public UpdateType get_UpdateType() 

virtual sealed Void System. Windows.IApplyValue.Apply(DependencyObject target, 

DependencyProperty dp) 
public Void set_BindFlags(BindFlags value) 
public Void set_BindType(BindType value) 
public Void set_Culture(CultureInfo value) 
public Void set_DataContextSource(String value) 
public Void set_DataSource(Object value) 
public Void set_ElementSource(String value) 
public Void set_ObjectSource(Object value) 
public Void set_Path(String value) 
public Void set_Source(ObjectRef value) 
public Void set_Transformer(IDataTransfonner value) 
public Void set_UpdateTypeGJpdateType value) 

} 

enum sealed System. Windows.Data.BindFlags : Enum : ValueType : Object 
Implements: IComparable fformattable IConvertible 
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{ 

public static BindFlags NotifyOnTransfer 

} 

5 Get the Bind Declaration Object of a Binding Expression 

Provides access to the single run-time instance of a binding. This class 

cannot be inherited. 

Method Description 

Equals - Determines whether two Object instances are equal. Liherited 

10 from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection, hiherited 
from Object. 

GetDataContext - Returns a data context. This method is a static 
1 5 accessor for a given bmding's data context object. 

GetHashCode - Serves as a hash function for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Liherited from 
Object. 

GetSources - Returns an array list of sources for the original binding 

20 expression. 

GetType - Gets the Type of the current instance. Inherited from Object. 
GetValue - Returns the evaluated value of a binding expression. This 
method is intended to be called statically. 

GetView - Returns collection views of the data in the binding. 
25 GetXmlNamespaceManager - Returns an Extensible Markup Language 

(XML) namespace manager object used by the binding attached to the provided 
element. 

MemberwiseClone - Creates a shallow copy of the current Object. 
Inherited from Object. 
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OnAttach - Handles the notification that a binding expression has been 
set as a property's value. This method is called statically, but generally is not used by 
application code. 

OnDetach - Handles the notification that a binding expression has been 
5 removed as a property's value. This method is called statically, but generally is not used 

by application code. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Laherited fi-om Object. 

SetDataContext - Sets the data context of a binding for a given 
10 object/property combination. This method is intended to be called statically. 

SetValue - Sets the value of a binding. Retums a value that indicates 
whether the given value could be accepted. This method is intended to be called 
statically. 

SetXmlNamespaceManager - Sets a namespace manager object used by 

15 the binding attached to the provided element. 

ToString - Retums a String that represents the current Object. Inherited 

from Object. 

Update - Propagates the current value of the target property of a binding 
back to the source object. 

20 

Property Description 

Dataltem - Gets the data item currently in use by the binding. This could 
be a single object, or a collection, depending on the path conditions that established the 
25 binding. 

DataSource - Gets the source of the binding, as a data source object. This 
might be an element from within the appUcation or markup, or an external object that is 
specified as the data source resource. 

ParentBind - Gets the Bind declaration object from which this Binding 

30 derived. 
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Status - Gets the status of a Binding. 



Field Description 

DataContextProperty - Declares the DependencyProperty for a binding's 
data context so that it can be set as a property in the *Bind syntax. 

DataTransferEventID - A field that is used to identify the routing 
identifier (ID) for data transfer events. Reference this field statically. 

XmlNamespaceManagerProperty - Declares the DependencyProperty 
for a binding's XML namespace manager, so that it can be set as a property in the *Bind 
syntax. 

This class can be used to get the Bind Declaration Object of a Binding 
Expression, get the Status of a Binding, and control Updates to Data Bindings. 

A related class. Bind, provides access to the bind declaration. The bind 
declaration is where you specify the property or path used in the binding and other 
declarations. The declaration can be specified either as properties of Bind or by using 
the bind declaration syntax in markup when first setting a DataContext on an element. 

A Binding object can be obtained through the return value of calling 
GetBinding on a data bound object. 

Get the Bind Declaration Object of a Binding Expression 

The following C# example shows how to obtain the bind declaration 
object associated with a binding, by using the binding's target element and property. 
Having the bind declaration object available is useful because you may want to set or 
get properties that are carried in the declaration. Also, you could use this same 
declaration to quaUfy much of the bind declaration information needed for a totally 
different binding using the same data. To get the Bind declaration object, you need to 
get the Binding for a specified property on a target element. Then get the ParentBind 
property of the Binding object. 
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Binding myBinding = mytext.GetBinding(SimpleText.TextProperty); 

if(myBinding!=null) 

{ 

Bind myBindDec; 

myBindDec = myBinding.ParentBind; 

... //now change properties of the bind declaration, or re-use it for 

another binding 
} 

class sealed System.Windows.Data.Binding : Expression : Object 

{ 

public Object get_DataItemO 
public Object get_DataSource() 
public Bind get_ParentBindO 
public BindStatus get_StatusO 

public static Object GetDataContext(DependencyObject d) 
public virtual DependencySource[] GetSourcesQ 

public virtual Object GetValue(DependencyObject d, DependencyProperty dp) 
public static CoUectionView GetView(Object collection) 
public static CoUectionView GetView(Object collection, String name) 
public static Object GetXmlNaniespaceManager(DependencyObject d) 
public virtual Void OnAttach(DependencyObject d, DependencyProperty dp) 
public virtual Void OnDetach(DependencyObject d, DependencyProperty dp) 
public static Void SetDataContext(DependencyObject d. Object value) 
public virtual Boolean SetValue(DependencyObject d, DependencyProperty dp. 
Object value) 

public static Void SetXmlNamespaceManager(DependencyObject d, 

XmlNamespaceManager value) 

public VoidUpdateO 
pubUc static readonlyDependencyProperty DataContextProperty 
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public static readonlyRoutedEventID DataTransferEventlD 

public static readonlyDependencyProperty XmlNamespaceManagerProperty 

} 

enum sealed System. Windows.Data.Binding+BindStatus : Enum : ValueType : Object 

Implements: IComparable IFormattable IConvertible 

{ 

public static BindStatus Active . 
public static BindStatus Detached 
public static BindStatus Inactive 
public static BindStatus NoDataltem 
public static BindStatus PathError 

} 

A collection view class used for Microsoft® ActiveX® Data Objects 
(ADO) data views. 

Event Description 

CoUectionChanged occurs when the collection view changes. This could 
mean that items were added or removed in the collection, or that a new sort or filter was 
applied to this view. Inherited from CoUectionView. 

CurrentChanged occurs immediately after the record pointer position 

moves. 

CurrentChanging occurs when a request is made to move the current 
record pointer. The requested move can be canceled by setting a handler and using the 
CancelEventArgs object within arguments of the event to cancel the event. 

ProtectedCurrentChanged - A protected event. In derived classes, this 
event occurs after changing the position of the record pointer. Inherited from 
CoUectionView. 
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ProtectedCuirentChanging - A protected event. In derived classes, this 
event occurs before a change in currency. If necessary, handlers of the event can cancel 
the change, hiherited from CoUectionView. 

Method Description 

BindingListCoUectionView - Initializes a new instance of the 

BindingListCoUectionView class. 

ChangedCurrent - Raises the implemented CurrentChanged event of the 

object. Inherited from CoUectionView. 

CheckUiContextAccess - Determines whether the calling thread is active 

within the context this collection view is bound to. Inherited from 
ContextAffinityCoUectionView. 

Compare - Return -, 0, or +, according to whether ol occurs before, at, or 

after o2 (respectively) 

Contains - Return true if the item belongs to this view. The item is 
assumed to belong to the underlying DataCoUection; this method merely takes filters 
into account. It is used during collection-changed notifications, for instance. 

Containsltem - Return true if the item belongs to this view. No 
assumptions are made about the item. If the caller knows that the item belongs to the 
underlying collection, it is more efficient to call Contains. 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetEnumerator - Implementation of lEnumerable.GetEnumeratorO. This 
provides a way to enumerate the members of the collection without changing the 
currency. 
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GetHashCode - Serves as a hash function for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
IndexOf - Return the index where the given item belongs 
MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

MoveFirst - Move Current to the first item. 
MoveLast - Move Current to the last item. 
MoveNext - Move Current to the next item. 
MovePrevious - Move Current to the previous item. 
MoveTo - Move Current to the given item. 

OKToChangeCurrent - Determines whether it is allowable to change the 
position of the current record pointer. Inherited from CoUectionView. 

OnCoUectionChanged - hnplement this method to handle 
CoUectionChanged events in the data collection that underlies the collection view. 
Inherited from CoUectionView. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

Refresh - Refreshes the view. Re-applies any current sort or filter 
operations, as set by various properties that declare sort or filter critena. 

ToString - Returns a String that represents the current Object. Inherited 

fixjm Object. 

VerifyUiContextAccess - Verifies that the calling thread is active within 
the context that this collection view is bound to. If not, an exception is raised. Inherited 
from ContextAffinityCoUectionView. 



Property Description 

BOF - Return true if Current is before the beginning (Beginning-Of- 



File). 
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CanFilter - Gets a value that declares whether this view can be filtered 
on tiie basis of its Filter property. Inherited firom CoUectionView. 

CanSort - Test if this CoUectionView supports sorting before assigning a 

non-null value to Sort. 

Collection - Gets the underlying data collection object. Inherited firom 

CoUectionView. 

Comparer - Gets the comparison object being used by the collection 
view. Inherited firom CoUectionView. 

Count - Return the estimated number of records (or -1, meaning "don't 

know"). 

Current - Return current item. 

Currentltem - Gets the current object in the data coUection, by returning 
an object that implements a Current property as well as several other methods for 
moving or checking currency. Inherited firom CoUectionView. 

EOF - Return true if Current is beyond the end (End-Of-File). 

Filter - Gets or sets the filter appUed to the data in a data collection view. 
Inherited from CoUectionView. 

Sort - Gets or sets the sort descriptions that apply a sort order to the 

collection. 

UlContext - Gets the user interface (UI) context that this collection view 
is bound to. hiherited from ContextAfifinityCoUectionView. 

ViewManagerData Gets implementation data about a view. Inherited 
from CoUectionView. 

class sealed System. Windows.Data.BindingListCoUectionView 
ContextAffinityCoUectionView : CoUectionView : Object Implements: lEnumerable 
ICoUectionChange ICurrentltem IComparer 
{ 

pubUc virtual sealed Int32 Compare(Object ol, Object o2) 
pubUc virtual Boolean Contains(Object item) 
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public virtual Boolean ContainsItem(Object item) 

public virtual sealed Boolean get_BOF0 

public virtual Boolean get_CanSortO 

public virtual Int32 get_CountO 

public virtual sealed Object get_Current() 

public virtual sealed Boolean get_EOF0 

public virtual SortDescription[] get_SortO 

public virtual Enumerator GetEnumeratorQ 

public virtual Int32 IndexOf(Object item) 

public virtual sealed Boolean MoveFirstQ 

public virtual sealed Boolean MoveLastQ 

public virtual sealed Boolean MoveNextQ 

public virtual sealed Boolean MovePreviousQ 

public virtual sealed Boolean MoveTo(Object item) 

public virtual Void RefreshQ 

public virtual Void set_Sort(SortDescription[] value) 

} 

enum sealed System.Windows.Data.BindType : Enum : ValueType : Object 

Implements: IComparable IFormattable IConvertible 

{ 

public static BindType OneTime 
public static BindType OneWay 
public static BindType TwoWay 

} 

Implements a collection view that includes checks for context affinity. 
Event Description 
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CoUectionChanged - Occurs when the collection view changes. This 
could mean that items were added or removed in the collection, or that a new sort or 
filter was applied to this view. Inherited firom CoUectionView. 

ProtectedCurrentChanged - A protected event. In derived classes, this 
5 event occurs after changing the position of the record pointer. Inherited from 
CoUectionView. 

ProtectedCurrentChanging - A protected event. In derived classes, this 
event occurs before a change in currency. If necessary, handlers of the event can cancel 
the change. Inherited from CoUectionView. 

10 

Method Description 

ChangedCurrent - Raises the implemented CurrentChanged event of the 
object. Inherited from CoUectionView. 

CheckUiContextAccess - Determines whether the calling thread is active 
1 5 within the context this collection view is bound to. 

Contains - Determines whether a given data item belongs to this 
collection view. Inherited from CoUectionView. 

Containsltem - Determines whether a given data item belongs to this 
coUection view or the unfiltered collection. Inherited from CoUectionView. 
20 ContextAffinityCollectionView - Create a view to given collection. 

Equals - Determmes whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
25 from Object. 

GetEnumerator - Retums an enumerator that can iterate through the 
collection view. Inherited from CoUectionView. 

GetHashCode - Serves as a hash fimction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
30 Object. 
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GetType - Gets the Type of the ciurent instance. Inherited from Object. 
IndexOf - Returns the index where the given data item belongs in the 
collection, or -1 if the index of that item is unknown. Liherited from CoUectionView. 

MemberwiseClone - Creates a shallow copy of the current Object. 

5 Liherited from Object. 

OKToChangeCurrent - Determines whether it is allowable to change the 
position of the current record pointer. Inherited from CoUectionView. 

OnCoUectionChanged - Implement this method to handle 
CoUectionChanged events in the data collection that underUes the collection view. 
1 0 Inherited from CoUectionView. 

ReferenceEquals - Determines whether the specified Object instances 
are the same instance. Inherited from Object. 

Refresh - Refreshes the view. Reapplies any current sort or filter 
conditions, as set by various properties that declare sort or filter criteria. Inherited from 
15 CoUectionView. 

ToString - Returns a String that represents the current Object. Inherited 

from Object. 

VerifylliContextAccess - Verifies that the calling thread is active within 
the context that this collection view is bound to. If not, an exception is raised. 

20 

Property Description 

CanFUter - Gets a value that declares whether this view can be filtered 
on the basis of its Filter property. Inherited from CoUectionView. 

CanSort - Gets a value that declares whether the coUection can be sorted 
25 on basis of its Sort property. Inherited from CoUectionView. 

Collection - Gets the underlying data collection object. Inherited from 
CoUectionView. 

Comparer - Gets the comparison object being used by the collection 
view. Inherited from CoUectionView. 
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Count - Gets the count of records in the collection. Inherited from 
CoUectionView. 

Currentltem - Gets the current object in the data collection, by returning 
an object that implements a Current property as well as several other methods for 
5 movmg or checking currency. Inherited from CoUectionView. 

Filter - Gets or sets the filter applied to the data in a data collection view. 
Inherited fi:om CoUectionView. 

Sort - Gets or sets the sort order within the data collection view. 

Inherited from CoUectionView. 
1 0 UlContext - Gets the user interface (UI) context that this collection view 

is bound to. 

ViewManagerData - Gets implementation data about a view. Inherited 
from CoUectionView. 

1 5 abstract class System.Windows.Data.ContextAffinityCollectionView : 

CoUectionView : Object Implements: lEnumerable ICoUectionChange 
{ 

protected Boolean CheckUiContextAccessQ 
protected UlContext get UIContextQ 
20 protected Void VerifyUiContextAccessQ 
} 

class sealed System.Windows.Data.DataChangedEventHandler : MuWcastDelegate : 
Delegate : Object Implements: ICloneable ISerializable 
25 { 

public virtual lAsyncResult BeginInvoke(Object sender, Event Args args, 
AsyncCallback callback, Object object) 
pubUc virtual Void EndInvoke(IAsyncResult result) 
public virtual Void Invoke(Object sender, EventArgs args) 

30 } 
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Supports object references to elements whose DataContext is being used 
as the source for a binding. This class cannot be inherited. 

Method Description 

DataContextObjectRef Initializes a new instance of the 

DataContextObjectRef class. 

Equals Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

FindRootElement - Finds the root element for a given element, hiherited 
from ObjectRef 

GetDataObject - Returns the object that estabUshed data context for the 
specified object. 

GetHashCode - Serves as a hash ftmction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetObject - Retums the object that estabUshed data context for the 
specified object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

ToString - Retums a String that represents the current Object. Inherited 

from Object. 
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class sealed System.Windows.Data.DataContextObjectRef : ObjectRef : Object 
{ 

public virtual Object GetDataObject(DependencyObject d) 
public virtual Object GetObject(DependencyObject d) 

5 } 

class sealed System. Windows.Data.DataSourceObjectRef: ObjectRef: Object 
{ 

public virtual Object GetDataObject(DependencyObject d) 
10 public virtual Object GetObject(DependencyObject d) 

} 

Encapsulates arguments for data transfer events. The events are routed 
events that must typically be handled specifically by a designated handler based on the 
DataTransferEventHandler delegate. 

15 

Property Description 

Handled - Sets or retrieves a value that indicates the present state of the 
event handling. Inherited fix>m RoutedEventArgs. 

OriginalSource - Retums OriginalSource object that raised the 
20 RoutedEvent. Inherited from RoutedEventArgs. 

Property - Gets the specific property that changed and caused the data 

transfer event to be raised. 

RoutedEventID - Retums the RoutedEventID associated with this 
RoutedEventArgs. Inherited fix>m RoutedEventArgs. 
25 Source - Gets the object that raised the event. Inherited firom 

RoutedEventArgs. 

Field Description 

Empty - Represents an event with no event data. Inherited fi-om 

30 EventArgs. 
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Method Description 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

5 Finalize - Allows an Obj ect to attempt to free resources and perform 

other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetHashCode - Serves as a hash fimction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
10 Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
InvokeEventHandler - Raises the data transfer event. 
MemberwiseClone - Creates a shallow copy of the current Object. 
Inherited from Object. 

1 5 OnSetSource - Invoked when the source of the event is set. hiherited 

from RoutedEventArgs. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

SetRoutedEventID - Sets the RoutedEventID to the specified value 

20 Inherited from RoutedEventArgs. 

SetSource - Sets the Source Property to the specified value Inherited 

from RoutedEventArgs. 

ToString - Returns a String that represents the current Object. Inherited 

from Object. 

25 

class System. Windows.Data.DataTransferEventArgs : RoutedEventArgs : EventArgs : 

Object 

{ 

public DependencyProperty get_Property() 
30 protected virtual Void InvokeEventHandler(Delegate genericHandler, Object 
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genericTarget) 
} 



Represents the method that handles a data transfer event raised by 

Binding. 

Parameters 

sender - System.Object. The source object (instance of Binding) that 
raised the event. 

args - System.Windows.Data.DataTransferEventArgs. Arguments of the 
event, as an instance of DataTransferEventArgs. 

Return Value 
System. Void. 

Arguments of the event will inform you which bound property within the 
binding transferred data. 

Binding does not expose this event as a member, but does expose the 
static DataTransferEventID property that is used to identify the event and attach a 
handler to that event. 

How Do I Notify when Data is Transferred? 

This example describes how to set up notification when data is 
transferred from the source to the target property. 

According to one embodiment the operating system "Avalon" raises a 
data transfer event each time that data transfers from the source of a binding to a target. 
Internally, this event is used to inform the user interface (UI) that it should update, 
because the bound data has changed. Note that in order for the data transfer event to 
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work, and also in order for one-way or two-way binding to work properly, you need to 
implement your data class using the IPropertyChange interface. For details on creating 
data items or classes that implement this interface, see Create a One-Way Binding to a 
Dynamically Updated Data Source. 

In order to make this event available to your application, set the 
NotifyOnTransfer flag in the bind declaration. This can be done in a particular markup 
language (named "XAML"), using either the *Bind syntax or the BindFlags attribute of 
Bind, or in C#, by using parameters of the bind declarations. The handler you use to 
listen for this event must typically be attached directly to the element where you want to 
be informed of changes, or to the overall data context if you want to be aware that 
anything in the context has changed. 

<SimpleText ID="RentText" 
Text="*Bind(Path=Rent;BindType=OneWay;BindFlags=NotifyOnTransfer)" 

Canvas.Top="50px" Canvas.Left="140px" Width="120px" 

Height="20px" /> 

In the code, assign a handler based on the DataTransferEventHandler 
delegate, OnDataTransfer in this example, to handle the data transfer event. Use 
Binding-DataTransferEventlD to get the necessary routing ID. 

In this C# sample, clicking a button will cause new data to be generated 
and the values in various text boxes will be updated. When the event is raised and 
handled, a "Data Updated ..." message is printed. Parameters of the event can be used to 
determine details about the property that changed (such as the type or the specific 
element if the same handler is attached to more than one element), which can be useful 
if there are multiple bound properties on a single element. 

RentText.AddHandler(Binding.DataTransferEventID,new 
DataTransferEventHandler(OnDataTransfer)); 
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public void OnDataTransfer(Object sender, DataTransferEventArgs 

args) 

{ 

FrameworkElement fe = sender as FrameworkElement; 
InfoText.Text = ""; 

InfoText.Text += args.Property.Name + " property of a " + 
args.Property.OwnerType.Name; 

InfoText.Text += " element ("; 

InfoText.Text+=fe.ID; 

InfoText.Text += ") updated..."; 

InfoText.Text += (String) 
System.DateTime.Now.ToLongDateStringO; 

MoTexLText += " at "; 

InfoText.Text += (String) 
System.DateTime.Now.ToLongTimeStringO; 
} 

class sealed System. Windows.Data.DataTransferEventHandler : MulticastDelegate 

Delegate : Object Implements: ICloneable ISerializable 

{ 

public virtual lAsyncResult BeginInvoke(Object sender, 
DataTransferEventArgs args, AsyncCallback callback, Object object) 
public virtual Void EndInvoke(IAsyncResult result) 
public virtual Void Invoke(Object sender, DataTransferEventArgs args) 

} 
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Represents an object reference to an element, with the object being 
specified by its element ID. This class cannot be inherited. 



Method Description 

ElementObjectRef - Liitializes a new instance of the ElementObjectRef 

class. 

Equals - Determines whether two Object instances are equal, hiherited 

from Object. 

Finalize - Allows an Object to attempt to fi-ee resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection, hiherited 
firom Object. 

FindRootElement - Finds the root element for a given element. Inherited 
fi-om ObjectRef. 

GetDataObject - Within derived classes, returns the data context object 
associated with the referenced object. Inherited &om ObjectRef. 

GetHashCode - Serves as a hash function for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table, hiherited from 
Object. 

GetObject - Returns the referenced object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited &om Object. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

ToString - Returns a String that represents the current Object, hiherited 

from Object. 
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class sealed System. Windows.Data.ElementObjectRef : ObjectRef : Object 
{ 

public virtual Object GetObject(DependencyObject d) 

} 

Represents an explicit object reference to an element. This class cannot 

be inherited. 

Method Description 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

ExpHcitObjectRef - Initializes a new instance of the ExpUcitObjectRef 

class. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

FindRootElement - Finds the root element for a given element. Inherited 
from ObjectRef 

GetDataObject - Within derived classes, retums the data context object 
associated with the referenced object. Inherited from ObjectRef 

GetHashCode - Serves as a hash fimction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetObject - Retums the referenced object for the given 
DependencyObject context. 

GetType - Gets the Type of the current instance. Inherited from Object. 

MemberwiseClone - Creates a shallow copy of the current Object. 
Inherited from Object. 

ReferenceEquals - Determines whether the specified Object instances 
are the same instance. Inherited from Object. 

ToString - Returns a String that represents the current Object. Inherited 

from Object. 
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This class is used to provide explicit references (by identifier (ID)) to 
objects used as source objects for bindings. 

This class is a subclass of ObjectRef. 

5 

How Do I Create a Binding ? 

This example shows how to create a binding in C#. To do this, you 
attach the binding object for the SampleText source property in data to the Text 
10 property of the SimpleText element, mytext. 

When calling the Bind constructor, you can pass the source object 
through the ExplicitObjectRef constructor to get an ObjectRef object. There are many 
possible signatures both for the Bind constructor and for the SetBinding convenience 

15 method, and it is even possible to create the entire binding with the convenience method 
without calUng the Bind constructor at all, but this example splits the operation into the 
constructor piece and then the specific setting of that bind declaration on an individual 
property of an element. If you do this in two steps, then the bind declaration created as 
the intermediate can be reused for binding to more than one element in your appUcation. 

20 pubUc void CreateBindingO 

{ 

myDataObject = new myData(System.DateTime.Now); 

myBindDef = new Bind("MyDataProperty", BindType.TwoWay, new 

ExplicitObjectRefi[myDataObject)); 
25 mytext.SetBinding(SimpleText.TextProperty, myBindDef); 



} 



class sealed System. Windows.Data.ExplicitObjectRef : ObjectRef : 

30 Object 
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{ 

public virtual Object GetObject(DependencyObject d) 

} 

abstract interface System.Windows.Data.IContams 

5 { 

public virtual Boolean Contains(Object item) 

} 

abstract interface System.Windows.Data.IDataSource 

{ 

10 public virtual Object get_DataO 
public virtual Void RefreshQ 

} 

abstract interface System.Windows.Data.IDataTransformer 

15 { 

public virtual Object InverseTransform(Object o, Propertylnfo info, Culturelnfo 
culture) 

public virtual Object Transform(Object o, DependencyProperty dp, Culturelnfo 
culture) 
20 } 

Implements a collection view for collections based on IList. 
Event Description 

25 CoUectionChanged - Occurs when the collection view changes. This 

could mean that items were added or removed in the collection, or that a new sort or 
filter was applied to this view, hiherited from CoUectionView. 

ProtectedCurrentChanged - A protected event, hi derived classes, this 
event occurs after changing the position of the record pointer. Inherited from 

30 CoUectionView. 

52 



ProtectedCurrentChanging - A protected event. In derived classes, this 
event occurs before a change in currency. If necessary, handlers of the event can cancel 
the change. Inherited from CoUectionView. 

5 Method Description 

ChangedCurrent - Raises the implemented CurrentChanged event of the 

object. Inherited from CoUectionView. 

CheckUiContextAccess - Determines whether the calling thread is active 

within the context this collection view is bound to. Inherited from 
10 ContextAffmityCoUectionView. 

Contains - Determines whether a given data item belongs to this 

collection view. 

Containsltem - Determines whether a given data item belongs to this 
collection view or to the unfiltered collection. 
15 Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

20 GetEnumerator - Returns an enumerator that can iterate through the 

collection view. 

GetHashCode - Serves as a hash function for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

25 GetType - Gets the Type of the current instance. Inherited from Object. 

IComparer.Compare - Implements the comparison algorithm used by 
sorting in this collection. This method is not intended to be called directly. 

ICurrentItem.MoveFirst - Moves the record pointer to the first record in 

the collection view. 
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ICurrentttem-MoveLast - Moves the record pointer to the last record in 

the collection view. 

ICurrentItem.MoveNext - Moves the record pointer to the next record in 

the collection view. 

ICurrentItem.MovePrevious - Moves the record pointer to the previous 

record in the collection view. 

ICurrentItem.MoveTo - Moves the record pointer to the specified record 

in the collection view. 

IndexOf - Returns the index where the given data item belongs in the 
collection, or -1 if the index of that item is unknown. 

ListCoUectionView - Initializes a new instance of the 
ListCoUectionView class, using a supplied IList-derived collection. 

MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

OKToChangeCurrent - Determines whether it is allowable to change the 
position of the current record pointer. Inherited from CoUectionView. 

OnCoUectionChanged - Implement this method to handle 
CoUectionChanged events in the data collection tiiat underlies the collection view. 
Inherited from CoUectionView. 

PrepareLocalArray - Creates, filters and sorts the local index array. This 
method is also called when you call Refresh. 

ReferenceEquals - DetCTmines whether the specified Object instances 
are the same instance. Inherited from Object. 

Refresh - Refreshes the view. Re-applies any current sort or filter 
operations, as set by various properties that declare sort or filter criteria. 

ToString - Returns a String that represents the current Object, hiherited 

from Object. 

VerifyUiContextAccess - Verifies that the calling thread is active within 
the context that this collection view is bound to. If not, an exception is raised. Inherited 
from ContextAffinityCoUectionView. 
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Property Attribute Description 

ActiveComparer - Gets the current active comparer used in sorting. 
ActiveFilter - Gets the current active Contains information used in 

5 filtering. 

CanFilter - Gets a value that declares whether this view can be filtered 
on the basis of its Filter property. Inherited firom CoUectionView. 

CanSort - Gets a value that declares whether the collection can be sorted 

on the basis of its Sort property. 
IQ Collection - Gets the underlying data collection object. Inherited from 

CoUectionView. 

Comparer - Gets the comparison object being used by the collection 
view. Inherited from CoUectionView. 

Count - Gets the count of records in the coUection. 
1 5 Currentlndex - Gets or sets the current index. 

Currentltem - Gets the current object in the data collection, by returning 
an object that implements a Current property as weU as several other methods for 
moving or checking currency. Inherited from CoUectionView. 

CustomFilter - Gets or sets the custom filter criteria applied to the 

20 collection by the view. 

CustomSort - Gets or sets the custom sort order appUed to the collection 

by the view. 

Filter - Gets or sets the filter applied to the data in a data collection view. 
Inherited from CoUectionView. 
25 IntemalList - Gets or sets the internal (complete, unfiltered) collection. 

Sort - Gets or sets the sort descriptions that apply a sort order to the 

collection. 

UlContext - Gets the user interface (UI) context that this coUection view 
is bound to. Inherited from ContextAffinityCoUectionView. 
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UsesLocalAiray - Gets a Boolean value that indicates whether sorting or 
filtering is taking place either on a local array copy or on the original data. 

ViewManagerData - Gets implementation data about a view. Inherited 
from CoUectionView. 

class System. Windows.Data.ListCollectionView : ContextAffmityCollectionView : 
CoUectionView : Object Implements: BEnumerable ICoUectionChange ICurrentltem 
IComparer 
{ 

public virtual Boolean Contains(Object item) 

public virtual Boolean ContainsItem(Object item) 

protected IComparer get_ActiveComparer() 

protected IContains get_ActiveFilterO 

public virtual Boolean get_CanSortO 

public virtual Int32 get_Count() 

protected Int32 get_CurrentIndex() 

public IContains get_CustomFilter() 

public IComparer get_CustomSort() 

protected IList get_IntemalList() 

public virtual SortDescription[] get_Sort() 

protected Boolean get_UsesLocalArrayO 

public virtual Enumerator GetEnumeratorQ 

public virtual Int32 IndexOf(Object item) 

virtual sealed Void 

System.ComponentModel.ICurrentItem.add_CurrentChanged(CurrentChangedEventHa 

ndler value) 
virtual sealed Void 

System.ComponentModel.ICurrentItem.add_CurrentChanging(CurrentChangingEvent 
Handler value) 

virtual sealed Boolean System.ComponentModel.ICurrentItem.get_BOF() 
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virtual sealed Object System.ComponentModel.ICuiTentItein.get_CurrentO 
virtual sealed Boolean System.ComponentModel.ICurrentItem.get_EOF0 
virtual sealed Boolean System.ComponentModel.ICurrentItem.MoveFirstO 
virtual sealed Boolean System.ComponentModel.ICurrentItem.MoveLastO 
virtual sealed Boolean System.ComponentModel.ICurrentltem.MoveNextO 
virtual sealed Boolean System.ComponentModel.ICurrentItem.MovePrevious() 
virtual sealed Boolean System.ComponentModel.ICurrenatem.MoveTo(Object item) 
virtual sealed Void 

System.ComponentModeliCurrentItem.remove_CuirentChanged(CurrentChm^^ 

tHandler value) 
virtual sealed Void 

System.ComponentModel.ICurrenatem.remove_CuirentChanging(CurrentChangingEv 
entHandler value) 

protected virtual IList PrepareLocalArray(IList list) 
public virtual Void RefireshQ 
protected Void set_ActiveComparer(IComparer value) 
protected Void set_ActiveFilter(IContains value) 
protected Void set_CurrentIndex(Int32 value) 
public Void set_CustomFilter(IContains value) 
public Void set_CustomSort(IComparer value) 
protected Void set_IntemalList(IList value) 
public virtual Void set_Sort(SortDescription[] value) 

virtual sealed Int32 System.CoUections.IComparer.Compare(Object ol, Object o2) 

} 

Serves as a data source for data binding. Bindable data items can be 
specified as common language runtime types. 

Event Attribute Description 

DataChanged - Raised when a new data object becomes available. 
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RefreshCompleted - Raised when the refresh operation has completed. 
This event is raised only if the data source is using Asynchronous mode. 
Method Description 

Equals - Determines whether two Object instances are equal. Inherited 

5 from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetHashCode - Serves as a hash ftmction for a particular type, suitable 
10 for use in hashing algorithms and data structures like a hash table, hiherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 
Inherited from Object. 

15 ObjectDataSource - Initializes a new instance of the ObjectDataSource 

class. 

ReferenceEquals - Determines whether the specified Object instances 
are the same instance. Inherited from Object. 

Refresh - Creates the mid-tier data object based on the cunrent value of 
20 the TypeName and Parameters properties. This method gets called automatically upon 

the first request for the data. 

ToString - Returns a String that represents the current Object, hiherited 

from Object. 

Property Attribute Description 
25 Asynchronous - Gets or sets a property that declares whether data object 

creation will be performed in a worker thread or in the active (UI) context. 
Data - Gets the underlying data object. 

Parameters - Gets or sets a comma-delimited string that describes the 
arguments to be passed to the constructor of the instantiated object. 
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TypeName - Gets or sets the name of the common language runtime type 
to instantiate. This can be a folly- qualified type name, or a type defined locally in the 
assembly of the page. 

5 class System.Windows.Data.ObjectDataSource : Object Implements: IDataSource 
{ 

public Boolean get_AsynchronousO 
public virtual sealed Object get_DataO 
public String get_ParametersO 
10 public String get_TypeNameO 

pubUc virtual sealed Void RefreshQ 
public Void set_Asynchronous(Boolean value) 
public Void set_Parameters(String value) 
public Void set_TypeName(String value) 

15 } 

The abstract class that is used as the parent class of ElementObjectRef, 
ExplicitObjectRef, and TypeObjectRef. 

Method Description 

20 Equals - Determines whether two Object instances are equal. Inherited 

fix>m Object. 

Finalize - Allows an Object to attempt to firee resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

25 FindRootElement - Finds the root element for a given element. 

GetDataObject - Within derived classes, returns the data context object 

associated with the referenced object. 

GetHashCode - Serves as a hash fonction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
30 Object. 
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GetObject - Within derived classes, returns the data context object 
associated with the referenced object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 

5 Inherited from Object. 

ObjectRef - Initializes a new instance of the ObjectRef class. This 

method is protected in the base class. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 
10 ToString - Returns a String that represents the current Object. Inherited 

from Object. 

abstract class System.Windows.Data.ObjectRef : Object 
15 { 

protected static DependencyObject FindRootElement(DependencyObject d) 
public virtual Object GetDataObject(DependencyObject d) 
public virtual Object GetObject(DependencyObject d) 

} 

20 

Objects of this class hold the collection of named parameters (with their 
corresponding values) for an SqlDataSource. 
Method Description 

Add - Adds a named parameter to the parameter collection given the new 

25 parameter's name and value. 

CopyTo - Copies all of the parameters in the parameter collection to a 
specified array, starting at a specified index in the array. 

Equals - Determines whether two Object instances are equal, hiherited 

from Object. 
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Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetEnumerator - Gets an lEnumerator interface that can be used to 
5 enumerate over the parameters in the collection. 

GetHashCode - Serves as a hash function for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
10 MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

ParameterCoUection - Initiates a new instance of the 

ParameterCoUection class. 

ReferenceEquals - Determines whether the specified Object instances 

15 are the same instance. Inherited from Object. 

ToString - Returns a String that represents the current Object. Inherited 

from Object. 

Property Description 

Count - Gets the count of parameters in this parameter collection. 
20 IsSynchronized - Gets a value that indicates whether access to this 

collection is synchronized (i.e., thread-safe). 

Item - An indexer that gets or sets the object value of a named parameter 

in the collection. 

SyncRoot - Gets an object that can be used to synchronize access to this 
25 parameter collection. 
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class System. Windows.Data.ParameterCollection : Object Implements: ICollection 
lEnumerable 

{ 

public Void Add(String paramName, Object initialValue) 
public virtual sealed Void CopyTo(Array array, Iiit32 index) 
public virtual sealed Int32 get CountQ 
public virtual sealed Boolean get_IsSynchronizedO 
public Object get_Item(String paramName) 
public virtual sealed Object get_SyncRootO 
public virtual sealed lEnumerator GetEnumeratorQ 
public Void set_Item(String paramName, Object value) 

} 

This class represents a single select statement to be submitted to the 

database. 

Method Description 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection, hiherited 
from Object. 

GetHashCode - Serves as a hash fimction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 

MemberwiseClone - Creates a shallow copy of the current Object. 
Inherited from Object. 

QueryCommand - Default constructor does nothing 

ReferenceEquals - Determines whether the specified Object instances are 
the same instance. Inherited from Object. 

62 



ToString - Returns a String that represents the current Object. Inheritec 

from Object. 

Property Attribute Description 

Table - Gets or sets the name of the table that will store query results. 
Text - Gets or sets the Structured Query Language (SQL) query string 
this query object. 



class System.Windows.Data.QueryCommand : Object 
10 { 

public String get_TableO 
public String get_TextO 
public Void set_Table(String value) 
public Void set_Text(String value) 

15 } 

Encapsulates the arguments passed either in the RefreshCompleted event 
of ObjectDataSource, or in the RefreshCompleted event of XmlDataSource. 

Field Description 

20 Empty - Represents an event with no event data. Inherited from 

EventArgs. 

Method Description 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

25 Finalize - Allows an Object to attempt to free resources and perform 

other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetHashCode - Serves as a hash function for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
30 Object. 
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GetType - Gets the Type of the currait instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

RefreshCompletedEventArgs - friitiaUzes a new instance of the 
RefreshCompletedEventArgs class. 

ToString - Returns a String that represents the current Object. Inherited 

from Object. 

Property Description 

Exception - Gets the exception raised if the refresh operation resulted in 

an error. 

class System. Windows.Data.RefreshCompletedEventArgs : EventArgs : Object 
{ 

public Exception get_ExceptionO 

} 

Represents the method that handles the ObjectDataSourccRefreshCompleted 
and XmlDataSource.RefreshCompleted events. 
Parameters 

sender System.Object. The object (data source) that raised the event, 
e System.Windows.Data.RefreshCompletedEventArgs. Arguments of 
the event, as an instance of RefreshCompletedEventArgs. 

Return Value System.Void. 

class sealed System. Windows.Data.RefreshCompletedEventHandler :MulticastDelegate 

: Delegate : Object Implements: ICloneable ISerializable 

{ 
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public virtual lAsyncResult BeginInvoke(Object sender, RefreshCompletedEventArgs 
e, AsyncCallback callback. Object object) 

public virtual Void EndInvoke(IAsyncResult result) 
public virtual Void Invoke(Object sender, RefreshCompletedEventArgs e) 

} 

A list of sql conunands and the names of the tables that they should be 

used to fill. 

Method Description 

Add - Adds a new SqlCommand object to the Ust. 
AddChild - This method is called to add a child to this object. 
AddText -This method is called when plain text appears under the tag in 

markup. In this case it is ignored. 

Clear - Removes all entries in the list. 

Contains - Determines if the specified QueryCommand is in the array. 
Both the Text and Table values must typically be equal to count as a match. 

CopyTo - Copies the entire SqlCommandList to the specified one 
dimentional array starting at the specified index of the target array. 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetEnumerator - Returns an enumerator which enumerates all 

QueryCommands in this set 

GetHashCode - Serves as a hash function for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
IList.Add 
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IList.Contains 
IList.IndexOf 
IList.Insert 
IList.Remove 

IndexOf - Returns the zero-based index of tiie first occurance of the 
specified value. 

MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited fi»m Object. 

Remove - Removes the first occurance of the specified QueryCommand 

from the hst. 

RemoveAt - Removes the QueryCommand at the given position. 
SqlCommandList 

ToString - Returns a String that represents the current Object. Liherited 

fixjm Object. 

Property Description 

Covmt - Returns the number of elements contained in the Ust. 
Item - Returns the QueryCommand at the given index. 

class System. Windows.Data.SqlCommandList : Object Implements: IList ICoUection 

innumerable lAddChild 

{ 

public Void Add(QueryCommand command) 

public virtual sealed Void AddChild(Object o) 

public virtual sealed Void AddText(String s) 

public virtual sealed Void ClearQ 

public Boolean Contains(QueryCommand value) 

public virtual sealed Void CopyTo(Array array, Int32 index) 

public virtual sealed Int32 get_CountO 
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public QueryCommand get_Item(Int32 index) 

public virtual sealed lEnumerator GetEnumeratoiO 

public Int32 IndexOf(QueryCoinmand value) 

public Void Remove(QueryCoinmand value) 

public virtual sealed Void RemoveAt(Int32 index) 

public Void set_Item(Int32 index, QueryCommand value) 

virtual sealed Boolean System.Collections.ICollection.get_IsSynchronizedO 

virtual sealed Object System.Collections.ICollection.get_SyncRootO 

virtual sealed Int32 System.Collections.IList.Add(Object command) 

virtual sealed Boolean System.Collections.IList.Contains(Object value) 

virtual sealed Boolean System.CoUections.IList.getJsFixedSizeO 

virtual sealed Boolean System.Collections.IList.get_IsReadOnly() 

virtual sealed Object System.Collections.IList.get _Item(Int32 index) 

virtual sealed Int32 System.Collections.IList.IndexOf(Object value) 

virtual sealed Void System.Collections.IList.Insert(Int32 index, Object command) 

virtual sealed Void System.Collections.IList.Remove(Object value) 

virtual sealed Void System.Collections.IList.set_Item(Int32 index. Object value) 

} 

According to one embodiment, SqlDataSource gets data from a 
Microsoft SQL Server for use in databinding. 

Event Attribute Description 

DataChanged - This event is raised when a new data object becomes 

available. 

WriteComplete - This event is fired when data has been written back 

the database. 

Method Description 

BeginParamChange - Temporarily defers any updates to the dataset 
(unless requested explicitly with RefreshQ) until the EndParamChange method is c£ 
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EndParamChange - Signals that parameters have been updated and that 
the dataset should be refreshed from the Sql server. This will not refresh the dataset if 
none of the parameters have been changed. To update the dataset unconditionally use 
the Refresh method. 

5 Equals - Determines whether two Object mstances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

10 GetHashCode - Serves as a hash fimction for a particular type, suitable 

for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 

1 5 Liherited from Object. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance, hiherited from Object. 

Refresh - Initiates a Refresh Operation on the DataSource that will 
ultimately result in the Data property to change, if the Data property changes the 
20 DataChanged event should fire. This method is called automatically at the first request 
for the data 

SqlDataSource - The default constructor creates a new SqlDataSource 
with a blank connection string and a blank query 

ToString - Returns a Sfring that represents the current Object. Inherited 

25 from Object. 

WriteChanges - Commits the changes made to the data back to the 

database asynchronously. 

Property Attribute Description 

ConnectionString - This is the Sql server connection string, it indicates 
30 things like where to find the sql server and what uid and password to use. 
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Data - Returns the underlying data object. 

DataSet - This gives the developer access to the underlying DataSet so 
the functionality of ADO can be used if necessary 

DataSourceMode - The DataSourceMode determines what sort of object 

5 will be returned as the .Data property. 

DeferredParamChange - This flag indicates whether to refresh the data 
set immediately when a parameter's value changes or wait until EndParamChangeQ 
mehtod is called. 

ReadResult - If an error happened when querying the database it can be 

10 viewed here 

Select - The collection of QueryCommand objects which are used to 

query the database. 

SelectParameters - Exposes the ParameterCoUection object which 

contains the names and values of all of the named parameters. 
15 WriteResult - If an error happened when writing changes back to the 

database it can be viewed here 

class System.Windows.Data.SqlDataSource : Object Implements: IDataSource 
{ 

20 public Void BeginParamChangeQ 

public Void EndParamChangeQ 

pubUc String get_ConnectionStringO 

public virtual sealed Object get_DataO 

public DataSet get_DataSetO 
25 public SqlDataSourceMode get_DataSourceModeO 

pubUc Boolean getDeferredParamChangeQ 

public Exception get_ReadResultO 

public SqlCommandList get_SelectO 

public ParameterCoUection get_SelectParametersO 
30 pubUc Exception get_WriteResultO 
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public virtual sealed Void RefreshQ 

public Void set_ConnectionString(String value) 

public Void set_DataSourceMode(SqlDataSourceMode value) 

public Void WriteChangesQ 

} 

enum sealed System. Windows.Data.SqlDataSource+SqlDataSourceMode : Enum : 

ValueType : Object Lnplanents: IComparable IFonnattable IConvertible 

{ 

public static SqlDataSourceMode DataReader 
public static SqlDataSourceMode DataSet 
public static SqlDataSourceMode XmlReader 

} 



Allows resource reference to a transformer class that is defined as code- 
behind in the current ^plication. 

Method Description 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Liherited 
from Object. 

GetHashCode - Serves as a hash function for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 

IDataTransformer.InverseTransform - Aliases your custom transformer's 
InverseTransform method implementation. This method is not intended to be called 
directly. 
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roataTransformer.Transforai - Aliases your custom transformer's 
Transform method implementation. This method is not intended to be called directly. 

MemberwiseClone - Creates a shallow copy of the current Object. 

hiherited from Object. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

ToString - Returns a String that represents the current Object. Inherited 



from Object. 



class. 



TransformerSource - Initializes a new instance of the TransformerSource 



Property Description 

TypeName - Gets or sets the assembly and class information for the 
transformer class that this TransformerSource instance is aUasing for. 

How Do I Transform Bound Data? 

This example shows how to transform data that is used in bindings. 

To transform data, you create a class that implements the 
IDataTransformer interface, which includes the Transform and InverseTransform 
methods. 

In this C# example, the transformer works against two possible 
properties of a binding: the text within a text block and the foreground color. The same 
transformer can return either result as the appropriate type, based on switching on the 
dp input parameter. This is a useful feature in a transformer because the transformer is 
attached to a bind declaration, and the same bind declaration can be used to create 
multiple bindings on a single data source for properties of different destination types. 

public class MyTransformer : IDataTransformer 
{ 
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public object Transform(object o, DependencyProperty dp, 
System.Globalization.CultureInfo culture) 
{ 

DateTime date = (DateTime)o; 
switch (dp.Name) { 
case "Text": 
return "Heute ist " + date.ToString("F", new 
System.Globalization.CultureInfo("de-DE")); 

case "Foreground": 
return Colors.Red; 
default: 
return o; 

} 

} 

public object InverseTransform(object o, 
System.Reflection.PropertyInfo info, System.Globalization.CultureInfo culture) 

{ 

return null; 

} 

} 

Using "XAML", a transformer class is an application resource. If the 
transformer code is written as code-behind inside the same application, the resource is 
created as a TransfonnerSource element. This TransformerSource element allows you 
to avoid a circular reference problem with trying to reference a custom element inside 
resources before the transformer class itself is compiled further down in the code. Then, 
to specify the transformer within a binding, set the transformer attribute to the resource 
name of your TransformerSource element in resources. This example uses compound 
syntax to set the binding, but the transformer can also be set in *Bind syntax. 



<Canvas 
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xmlns="http://schemas.inicrosoft.coin/2003/xamr* 

xmlns:def="Defimtion" def:Language="C#" 

def:Class="WCPSample.MarkupTransfonner" 

def:CodeBehind="default.xaml.cs" 

ID="root" 
> 

<Canvas.Resources> 
<ObjectDataSourcedef:Name="myDataSovirce" 
TypeName="WCPSample.myData,MarkupTransformerSample"/> 

<a'ransformerSourcedef:Name="MyTransfomerReference" 

TypeName="MyTransformer"/> 

</Canvas.Resources> 
<Canvas.DataContext> 
<BindDataSource="{niyDataSource}" BindType="OneWay" /> 

</Canvas.DataContext> 

<SimpleText Canvas.Top="10px" Canvas.Lefl="5px" 
FontWeight="Bold" FontSize="18" Text="Untransformed data7> 

<SimpleText Canvas.Top="30px" Canvas.Left="35px" 
Width="300px" ID="mytext" Text="*Bind(Path=TheDate)'7> 

<SimpleText Canvas.Top="50px" Canvas.Left="5px" 
FontWeight="Bold" FontSize="18" Text="Transfonned data7> 

<SimpleText Canvas.Top="70px" Canvas.Left="35px" Width="300px 
Height="30px" ID="mytransfonnedtext"> 
<SimpleText.Text> 
<Bind Path="TheDate" 
Transfonner=" {MyTransformerReference} "/> 
</SimpleText.Text> 
<SimpleText.Foreground> 
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<BindPath="TheDate" 
Transfonner=" {MyTransformerReference} "/> 
</SimpleText.Foreground> 
</SimpleText> 
</Canvas> 

Using C#, you can specify the transformer when you create a new bind 
declaration object. Get an instance of your transformer by calling its constructor, and 
pass that instance as an argument to either a property of an existing bind declaration or 
in the bind declaration constructor. In the following example, myChangedData is a 
custom data item, which contains the TheDate property. 
Bind myNewBindDef = new Bind( 
"TheDate", 
BindType.OneWay, 

new ExplicitObjectRef(myChangedData), 

UpdateType.Immediate, 

new MyTransformerO, 

newSystem.Globalization.CultureInfo("en-US") 

class System. Windows.Data.TransfonnerSource : Object Implements: 

IDataTransformer 

{ 

public String get_TypeNameO 
virtual sealed Object 

System.Windows.Data.IDataTransformer.InverseTransform(Objecto,PropertyInfo 
info, Culturelnfo culture) 
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virtual sealed Object 

System.Windows.Data.IDataTransformer.Transfonn(Object o, DependencyProperty dp, 

Culturelnfo culture) 

public Void set_TypeName(String value) 

} 

Supports object reference by type. This class cannot be inherited. 
Method Description 

Equals - Determines whether two Object instances are equal. Liherited 

from Object, 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

FindRootElement - Finds the root element for a given element, hiherited 
from ObjectRef. 

GetDataObject - Within derived classes, returns the data context object 
associated with the referenced object, hiherited from ObjectRef. 

GetHashCode - Serves as a hash fimction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Liherited from 
Object. 

GetObject - Returns the object reference for a given data context. 
GetType - Gets the Type of tiie current instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

ToString - Returns a String that represents the current Object. Inherited 

from Object. 

TypeObjectRef - Initializes a new instance of the TypeObjectRef class. 
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class sealed System.Windows.Data.TypeObjectRef : ObjectRef : Object 
{ 

public virtual Object GetObject(DependencyObject d) 

} 

enum sealed System. Windows.Data-UpdateType : Enum : ValueType : Object 

Implements: IComparable IFormattable IConvertible 

{ 

public static UpdateType Explicit 
public static UpdateType Immediate 
public static UpdateType OnLostFocus 

} 

The WinFSDataSource facilitates databinding of data stored in WinFS 
with Avalon applications 

Event Description 

DataChanged - This event gets fired when new data is available or when 
that data changes 

DataUpdated - This event gets fired following a call to WriteChangesQ 
Method Description 

Dispose - If the client choses to dispose this object it will close the 
FindResult if it is still open. Otherwise it will be done in the finalizer. 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

FinaUze - The Finalizer will close the FindResult if it has not been closed 

earlier 

GetHashCode - Serves as a hash fimction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 
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GetType - Gets the Type of the current instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

Refresh - This method causes the query to be executed and new data to 
be returned. When the new data is ready the DataChanged event is fired. 

ToString - Retums a String that represents the current Object. Inherited 

from Object. 

Update - Writes any changes to the data back to the winfs store 
WinFSDataSource - Default constructor 
Property Description 

ContextString - Use this property to specify a WinFS store other than the 

default store. 

Data - Retums the underlying data object 
Query - The Query object must typically have it's 



class System.Windows.Data. WinFSDataSource : Object Implements: IDataSource 
IDisposable 

{ 

public virtual sealed Void DisposeQ 
protected virtual Void FinalizeQ 
public String get_ContextStringO 
public virtual sealed Object getJDataQ 
public Query get_QueryO 
public virtual sealed Void RefreshQ 
public Void set_ContextString(String value) 
public Void set_Query(Query value) 
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public Void UpdateQ 

} 



XmlDataNamespaceManager Class - Used to declare namespaces to be 

used in Xml data binding XPath queries 
Method Description 

AddNamespace - Adds the given namespace to the collection. Inherited 
from XmlNamespaceManager. 

AddText - lAddChild implementation 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection, hiherited 
from Object. 

GetEnumerator - Provides support for the "foreach" style iteration over 
the collection of namespaces in the XmlNamespaceManager . Inherited from 
XmlNamespaceManager. 

GetHashCode - Serves as a hash ftmction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table, hiherited from 
Object. 

GetNamespacesInScope - Gets a collection of namespace names keyed 
by prefix which can be used to enumerate the namespaces currently in scope. Inherited 
from XmlNamespaceManager. 

GetType - Gets the Type of the current instance. Inherited from Object. 

HasNamespace - Gets a value indicating whether the suppUed prefix has 
a namespace defined for the current pushed scope. Inherited from 
XmlNamespaceManager. 

IAddChild.AddChild 

LookupNamespace - Gets the namespace URI for the specified prefix. 
Inherited fix>m XmlNamespaceManager. 
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LookupPrefix - Finds the prefix declared for the given namespace URI. 
Inherited from XmlNamespaceManager. 

MemberwiseClone - Creates a shallow copy of the current Object. 
Inherited from Object. 

PopScope - Pops a namespace scope off the stack. Inherited from 
XmlNamespaceManager. 

PushScope - Pushes a namespace scope onto the stack. Inherited from 
XmlNamespaceManager. 

ReferenceEquals - Determines whether the specified Object instances 
are the same instance. Inherited from Object. 

RemoveNamespace - Removes the given namespace for the given prefix. 
Inherited from XmlNamespaceManager. 

ToString - Retums a String that represents the current Object. Inherited 

from Object. 

XmlDataNamespaceManager - Constructor 
Property Description 

DefaultNamespace - Gets the namespace URI for the default namespace. 
Inherited from XmlNamespaceManager. 

NameTable - Gets the XmlNameTable associated with this object. 
Inherited from XmlNamespaceManager. 



class System. Windows.Data.XmlDataNamespaceManager : XmlNamespaceManager : 

Object Implements: IXmlNamespaceResolver lEnumerable lAddChild 

{ 

public virtual sealed Void AddText(String s) 

virtual sealed Void System. Windows.Serialization.IAddChild.AddChild(Object o) 

} 

Serves as a data source for data binding to Extensible Markup Language 
(XML) content nodes. 
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Event Attribute Description 

DataChanged - Raise this event when a new data object becomes 

available. 

RefreshCompleted - Notifies when the refiresh operation has completed. 
This event is typically only raised if the data source is asynchronous, and that typically 
will only be the case when the XML source is an external file rather than inline XML. 
Method Description 

Equals - Determines whether two Object instances are equal. Inherited 

fi-om Object. 

Fmalize - Allows an Object to attempt to firee resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetHashCode - Serves as a hash fiinction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

Parse - Parses the object's XML content, using the specified reader and 

context. 

ReferenceEquals - Determines whether the specified Object instances 
are the same instance. Inherited from Object. 

Refresh - Resets the data collection maintained by this object, based on 
the result from the XPath query. 

ToString - Returns a String that represents the current Object. Inherited 

from Object. 

XmlDataSource - Initializes a new instance of the XmlDataSource class. 



Property Attribute Description 
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Data - Gets the underlying data object. If the source of the data is an 
external file, the first access to this property will return null (because the data is handled 
asynchronously). 

Document - Gets or sets the underlying data as an XML document. This 
is the property representation of any inline XML data established for this object. 

Source - Gets or sets the Uniform Resource Identifier (URI) source of 
the external XML data used by this object. 

XmlNamespaceManager - Gets or sets the mamespace manager used for 

executing XPath queries. 

XPath - Gets or sets the XPath query used to produce an appropriate 
node list to use for data bmding this object. 

How Do I Bind to XML Data? 

This example describes how to bind to data in an XML data source. You 
can bind to a data source that is an XML node or a collection of XML nodes. 

In this particular markup language (named "XAML") example, a data 
source is coded in an application's main "XAML" page as one of the resources of an 
outermost DockPanel. The actual XML data is supplied within the resource. This 
arrangement is sometimes called an XML data island. 

The following example shows a very short XML data island that has a 
Books tree containing Book elements. The XmlDataSource resource is used to define 
the XML data source that contains the Books data. 



<DockPanelxmbis="http://schemas.microsoft.com/2003/xaml/" 

xmlns:def="Definition"> 

<DockPanel.Resources> 
<XmlDataSource def:Name="BookData" XPath="/Books"> 
<Books xmhis=""> 
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<Book ISBN="0-7356-0562-9" Stock="in"> 
<Title>XML in Action</Title> 
<Summary>XML Web Technology</Summary> 

</Book> 

<Book ISBN="0-7356- 1370-2" Stock="in"> 
<Title>Prograimning Microsoft Windows With C#</Title> 
<Sunimary>C# Programming Using the .NET 
Framework</Summary> 

</Book> 

<!- ... other Book entries ... --> 
</Books> 
</XmlDataSource> 

<Style def:Name="BookDataStyle"> 
<ContentPresenter/> 
<Style.VisualTree> 
<SimpleText FontSize="Small" Foreground="Black"> 
<SimpleText.Text> 
<Bind Path="Title7> 
</SimpleText.Text> 
</SimpleText> 
</Style.VisualTree> 
<ystyle> 

</DockPanel.Resources> 

<!-- Bind a ListBox to the query-selected books ~> 
<ListBox ItemStyle=" {BookDataStyle}"> 
<ListBox.Items> 
<CollectionContainer> 
<CollectionContainer.Collection> 
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<Bind DataSource=" {BookData}" Path="Book"/> 
</CollectionContainer.Collection> 
</CollectionContainer> 
</ListBox.Items> 
</ListBox> 
</DockPanel> 



An initial XPath query on the collection is coded hy assigning the XPath 
attribute. This query string value will cause the data source to appear as a collection of 
data items. By varying the XPath query on the data source, the initial XML data 
collection that is exposed can be controlled. The XmlDataSource is also given an 
identifier (ID) by assigning BookData to the def:Name attribute. 

A ListBox element can be used to bind to the XML data collection. The 
i "XAML" markup above shows code for a ListBox that displays the titles of the books in 
the collection. A data style is defined that binds to the Title element of each Book 
element in the data. This style is defined in the main DockPanel's resources so it can be 
shared within the scope of that DockPanel. The Style is given the name BookDataStyle. 
This style can then be repeatedly appUed by a ListBox control whose collection is 
0 bound to the BookData data source. The ListBox's ItemStyle attribute is how the item 
style is specified to the ListBox, 

class System.Windows.Data.XmlDataSource : Object Implements: IDataSource 
IParseLiteralContent 
25 { 

public virtual sealed Object get_DataO 
public XmlDocument get_DocumentO 
public String get_SourceO 

public XmlNamespaceManager get_XmlNamespaceManagerO 
30 public String get_XPathO 
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pubUc virtual Void Parse(TextReader textReader, ParserContext parserContext) 
public virtual sealed Void RefreshQ 
public Void set_DocumentpCmlDocument value) 
public Void set_Source(String value) 
5 public Void set_XmlNamespaceManager(XmlNamespaceManager value) 

public Void set_XPath(String value) 

} 

Declares an individual namespace within an Extensible Markup 
Language (XML) data source. 
10 Method Description 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection, hiherited 
15 from Object. 

GetHashCode - Serves as a hash function for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
20 MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

ReferenceEquals- Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

ToString - Returns a String that represents the current Object. Inherited 

25 from Object. 

XmlNamespace - friitializes a new instance of the XmlNamespace class. 
Property Description 

Prefix - Gets or sets the prefix to use for this namespace. 
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Uri - Gets or sets the Uniform Resource Identifier (URI) for this 

namespace. 

class System.Windows.Data.XmlNamespace : Object 
5 { 

public String get_PrefixO 
public String get_UriO 
public Void set_Prefix(String value) 
public Void set_Uri(String value) 

10 } 

The delegate to use for handlers that receive the DataContextChanged 

event. 

class sealed System.Windows.DataContextChangedEventHandler : MulticastDelegate : 
15 Delegate : Object Implements: ICloneable ISerializable 

{ 

pubUc virtual lAsyncResult Beginhivoke(Object sender, EventArgs args, 
AsyncCallback callback, Object object) 
public virtual Void EndLivoke(IAsyncResult result) 
20 public virtual Void Invoke(Object sender, EventArgs args) 

} 

Method Description 

AddHandler - Add an instance handler for the given RoutedEventID 

25 Inherited firom ContentElement. 

AddToEventRoute - Adds handlers for the current instance to the route 

Inherited fi-om ContentElement. 

BuildRoute - Builds the event route Inherited from ContentElement. 
CaptureMouse - Captures the mouse to this element. Inherited from 
30 ContentElement. 
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ClearAllBindings - Removes all bindings attached to an element. 
ClearBinding - Removes the binding attached to the specified 

DependencyProperty. 

ClearValue - Clears the local value of a property Inherited from 

DependencyObject. 

DeferLoad - This purpose of this method as the name indicates is to 

defer the firing of the Loaded event 

EndDeferLoad - This call is meant to match a prior DeferLoad call, 
thereby cause Loaded event to be fired if there are no more pending EndDeferLoad 
calls. 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

FindResource - Searches for a resource with the passed name and rettims 

it 

Focus - Focuses the keyboard on this element. Inherited from 

ContentElement. 

FrameworkContentElement - Create an instance of a 

FrameworkContentElement 

GetAnimationBaseValue - If the dependency property is animated this 
method will give you the value as if it was not animated. Inherited from 
ContentElement. 

GetAnimations - Retrieves an animation collection associated with a 
DependencylD on this element. Inherited from ContentElement. 

GetBinding - Returns the Binding for the specified property. 

GetHashCode - Serves as a hash fimction for a particular type, suitable 
for use in hashing algorithms and data structtu-es like a hash table. Inherited from 
Object. 
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GetLocalValueEnumerator - Create a local value enumerator for this 

instance Inherited from DependencyObject. 

GetRoutedEventEDs - Get RoutedEventlDs with handlers Inherited from 

ContentElement. 

5 GetType - Gets the Type of the current instance. Inherited from Object. 

GetValue - Retrieve the value of a property Inherited from 

DependencyObject. 

ILogicalTreeNode.OnNewParent 

ILogicalTreeNode.OnParentChanged 

10 InvaUdateProperty - Invalidates a property Inherited from 

DependencyObject. 

MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

OnDelayedlnvalidate - Inherited from DependencyObject during build. 
15 OnGotFocus - An event announcing that the keyboard is focused on this 

element, friherited from ContentElement. 

OnGotMouseCapture - An event reporting that this element got the 

mouse capnire. Inherited from ContentElement. 

OnlsFocusedChanged - An event reporting that the IsFocused property 

20 has changed. 

OnlsFocusWithinChanged - An event reporting that the IsFocusWithin 

property changed. 

OnlsMouseCapturedChanged - An event reporting that the 

IsMouseCaptured property changed. Inherited from ContentElement. 
25 OnlsMouseDirectlyOverChanged - An event reporting that the 

IsMouseDirectlyOyer property has changed. 

OnlsMouseOverChanged - An event reporting that the IsMouseOver 

property changed. 

OnKeyDown - An event reporting a key was pressed. Inherited from 

30 ContentElement. 
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OnKeyUp -An event reporting a key was released. Inherited from 
ContentElement. 

OnLostFocus - An event announcing that the keyboard is no longer 

focused Inherited from ContentElement. 
5 OnLostMouseCapture - An event reporting that this element lost the 

mouse capture. Inherited from ContentElement. 

OnMouseEnter - An event reporting the mouse entered this element. 

Inherited from ContentElement. 

OnMouseLeave - An event reporting the mouse left this element. 

10 Inherited from ContentElement. 

OnMouseLeftButtonDown - An event reporting the left mouse button 

was pressed. Inherited from ContentElement. 

OnMouseLeftButtonUp - An event reporting the left mouse button was 

released. Inherited from ContentElement. 
1 5 OnMouseMove - An event reporting a mouse move. Inherited from 

ContentElement. 

OnMouseRightButtonDown - An event reporting the right mouse button 

was pressed. Inherited from ContentElement. 

OnMouseRightButtonUp - An event reporting the right mouse button 

20 was released, hiherited from ContentElement. 

OnMouseWheel - An event reporting a mouse wheel rotation. Inherited 

from ContentElement. 

OnNewParent - Sets input parent to given new value Inherited from 

ContentElement. 

25 OnPreviewGotFocus - An event announcing that the keyboard is focused 

on this element, hiherited from ContentElement. 

OnPreviewKeyDown - An event reporting a key was pressed. Inherited 

from ContentElement. 

OnPreviewKeyUp - An event reporting a key was released, hiherited 

30 from ContentElement. 
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OnPreviewLostFocus - An event announcing that the keyboard is no 
longer focused Inherited from ContentElement. 

OnPreviewMouseEnter - When the mouse enters an element, set the 
cursor. We do this in a class handler, rather than overriding 
5 OnlsMouseDirectlyOverChanged, because that is a virtual which can be overridden and 

not called. 

OnPreviewMouseLeave - An event reporting the mouse left this element. 

Inherited from ContenlElemait. 

OnPreviewMouseLeflButtonDown - An event reporting the left mouse 

1 0 button was pressed. Inherited from ContentElement. 

OnPreviewMouseLeftButtonUp - An event reporting the left mouse 
button was released, hiherited from ContentElement. 

OnPreviewMouseMove - An event reporting a mouse move. Inherited 

from ContentElement. 
1 5 OnPreviewMouseRightButtonDown - An event reporting the right 

mouse button was pressed. Inherited from ContentElement. 

OnPreviewMouseRightButtonUp - An event reporting the right mouse 
button was released. Inherited from ContentElement. 

OnPreviewMouseWheel - An event reporting a mouse wheel rotation. 

20 Inherited from ContentElement. 

OnPreviewTextlnput - An event announcing some text input, hiherited 

from Contenffilement. 

OnPropertylnvalidated - Notification that a specified property has been 

invaUdated 
25 OnStyleChanged 

OnTextlnput - An event announcing some text input, hiherited from 

ContentElement. 

RaiseEvent - Raise routed event with the given args Inherited from 
ContentElement. 
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ReadLocalValue - Retrieve the local value of a property (if set) Inherited 
from DependencyObject. 

ReferenceEquals - Determines whether the specified Object instances 
are the same instance. Inherited from Object. 

ReleaseMouseCapture - Releases the mouse capture. Inherited from 
ContentElement. 

RemoveHandler - Remove all instances of the given handler for the 
given RoutedEventID Inherited from ContentElement. 

SetAnimations - Associates an AnimationCoUection with a 
DependencylD on this element. Inherited from ContentElement. 

SetBinding - Attaches a binding, 

SetContext - Associates this UlContextObject with a UlContext. 
Inherited from UlContextObject. 

SetResourceReference - Searches for a resource called name and sets up 
a resource reference to it for the passed property. 

SetValue - Sets the local value of a property Inherited from 
DependencyObject. 

ToString - Retums a String that represents the current Object. Inherited 

from Object, 

ValidateProperty - Retrieve the value of a property (for use by native 
cache backed custom get accessors) Inherited from DependencyObject. 

ValidatePropertyCore - Allows subclasses to participate in property 
value computation 

class System. Windows.FrameworkContentElement : ContentElement : 
DependencyObject : UlContextObject : Object Implements: HnputElement 
IFrameworklnputElement ILogicalTreeNode ILoaded 
{ 

pubUc Void ClearAllBindingsO 

public Void ClearBinding(DependencyProperty dp) 
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public Object get_DataContextO 
public Binding GetBinding(DependencyProperty dp) 
public Void set_DataContext(Object value) 
public Binding SetBinding(DependencyProperty dp, Bind bind) 
public Binding SetBindingPependencyProperty dp. String path) 
public Binding SetBinding(DependencyProperty dp, String path, BindType bindType) 
public Binding SetBinding(DependencyProperty dp. String path, BindType bindType, 
ObjectRef source) 

public Binding SetBinding(DependencyProperty dp. String path, BindType bindType, 
ObjectRef source, UpdateType updateType) 

public Binding SetBinding(DependencyProperty dp, String path, 
BindType bindType, ObjectRef source, UpdateType updateType, XDataTransforaier 
transformer) 

public Binding SetBinding(DependencyProperty dp. String path, 
BindType bindType, ObjectRef source, UpdateType updateType, IDataTransformer 
transformer, Culturelnfo culture) 

public Binding SetBinding(DependencyProperty dp. String path, 
BindType bindType, ObjectRef source, UpdateType updateType, IDataTransformer 
transformer, Culturelnfo culture, BindFlags bindFlags) 

public static readonlyDependencyProperty DataContextProperty 

} 

The base object for the Frameworks 
Event Attribute Description 
DataContextChanged - DataContextChanged event 
GotFocus - An event announcing that the keyboard is focused on this 
element. Inherited from UIElement. 

GotMouseCapture - An event reporting that this element got the mouse 

capture. Inherited from UIElement. 
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IsFocusedChanged - An event reporting that the IsFocused property 
changed. Inherited from UIElement. 

IsFocusWithinChanged - An event reporting that the IsFocusWithin 
property changed. 

5 IsMouseCapturedChanged - An event reporting that the 

IsMouseCaptured property changed. Liherited from UIElement. 

IsMouseDirectlyOverChanged - An event reporting that the 
IsMouseDirectlyOver property changed. Inherited from UIElement. 

IsMouseOverChanged - An event reporting that the IsMouseOver 
1 0 property changed. 

KeyDown - An event reporting a key was pressed. Inherited from 

UIElement. 

KeyUp - An event reporting a key was released. Inherited from 

UIElement. 

1 5 Loaded - This clr event is fired when IsLoaded becomes true 

LostFocus - An event announcing that the keyboard is no longer focused 
on this element. Inherited from UIElement. 

LostMouseCapture - An event reporting that this element lost the mouse 
capture. Inherited from UIElement. 
20 MouseEnter - An event reporting the mouse entered this element. 

Inherited from UIElement. 

MouseHover - An event reporting a mouse hover. 

MouseLeave - An event reporting the mouse left this element. Inherited 
from UIElement. 

25 MouseLeftButtonDown - An event reporting the left mouse button was 

pressed. Inherited from UIElement. 

MouseLeftButtonUp - An event reporting the left mouse button was 
released. Inherited from UIElement. 

MouseMove - An event reporting a mouse move. Inherited from 

30 UIElement. 
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MouseRightButtonDown - An event reporting the right mouse button 

was pressed. Inherited from UIElement. 

MouseRightButtonUp - An event reporting the right mouse button was 

released, hiherited from UIElement. 
5 MouseWheel - An event reporting a mouse wheel rotation. Inherited 

from UIElement. 

PreviewGotFocus - An event announcing that the keyboard is focused on 

this element. Inherited from UIElement, 

PreviewKeyDown - An event reporting a key was pressed. Inherited 

10 from UIElement. 

PreviewKeyUp - An event reporting a key was released. Inherited from 

UIElement. 

PreviewLostFocus - An event announcing that the keyboard is no longer 
focused on this element. Inherited from UIElement. 
1 5 PreviewMouseEnter - An event reporting the mouse entered this 

element. Inherited from UIElement. 

PreviewMouseHover - An event reporting a mouse hover. 
PreviewMouseLeave - An event reporting the mouse left this element. 

Inherited from UIElement. 
20 PreviewMouseLeftButtonDown - An event reporting the left mouse 

button was pressed. Inherited from UIElement. 

PreviewMouseLeftButtonUp - An event reporting the left mouse button 

was released. Inherited from UIElement. 

PreviewMouseMove - An event reporting a mouse move. Inherited from 

25 UIElement. 

PreviewMouseRightButtonDown - An event reporting the right mouse 

button was pressed. Inherited from UIElement. 

PreviewMouseRightButtonUp - An event reporting the right mouse 

button was released. Inherited from UIElement. 
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PreviewMouseWheel - An event reporting a mouse wheel rotation. 
Inherited from UIElement. 

PreviewTextlnput - An event announcing some text input. Liherited from 

UIElement. 

5 Texthiput - An event announcing some text input. Liherited from 

UIElement. 

Field Description 

AnimationEffectsProperty - Timeline property. Inherited from 

UIElement. 

10 ClipProperty - Clip Property Inherited from UIElement. 

ClipToBoundsProperty - ClipToBounds Property Inherited from 

UIElement. 

CursorProperty - CursorProperty 

DataContextProperty - DataContext DependencyProperty 
1 5 FlowDirectionProperty - FlowDirectionProperty 

FocusableProperty - The dependency ID for the Focusable property. 

HeightProperty - HeightProperty 

DDProperty - The dependency ID for the ID property. 

IsEnabledProperty - The dependency ID for the IsEnabled property. 
20 IsFocusedProperty - The dependency property for the IsFocused 

property. Inherited from UIElement. 

IsFocusWithinProperty - The dependency property for the 
IsFocusWithin property. 

IsMouseCapturedProperty - The dependency property for the 
25 IsMouseCaptured property. Inherited from UIElement. 

IsMouseDirectlyOverProperty - The dependency property for the 
IsMouseDirectlyOver property. Inherited from UIElement. 

IsMouseOverProperty - The dependency property for the IsMouseOver 

property. 

30 MarginProperty - MarginProperty 
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MaxHeightProperty - MaxHeight Property 
MaxWidthProperty - MaxWidth Property 
MinHeightProperty - MinHeight Property 
MinWidthProperty - MinWidth Property 

OpacityProperty - The Opacity property. Inherited from UIElement. 

StyleProperty - Style Dependency Property 

TimelineProperty - Timeline property. Inherited from UIElement. 

VisibilityProperty - The Visibility property. Inherited from UIElement. 

WidthProperty - Width Property 

Method Description 

AddHandler - See overloaded method for details Inherited from 

UIElement. 

AdjustEventSource - Allows adjustment to the event source hiherited 
from UIElement. 

Arrange - Parents or system call this method to arrange the internals of 
children on a second pass of layout update, hiherited from UIElement. 

ArrangeChildHelper - The helper method for a parent to call instead of 
Arrange on a child during layout. Reads Width, Height, Min/MaxWidth, 
Min/MaxHeight from the child, uses reference size to resolve percent values and calls 
Arrange method on a child with modified arrangeSize. 

ArrangeCore - ArrangeCore allows for the customization of the 
positioning of children. Inherited from UIElement. 

BuildRoute - Builds the EventRoute hiherited from UIElement. 

BuildRouteCore - Allows FrameworkElement to augment tiie 

EventRoute 

CaptureMouse - Captures the mouse to this element, hiherited from 

UIElement. 

ClearAllBindings - Removes all bindings attached to the element. 
ClearBinding - Removes the binding attached to the specified 
DependencyProperty. 



ClearValue - Clears the local value of a property Inherited from 

DependencyObject. 

DeferLoad - This purpose of this method as the name indicates is to 

defer the firing of the Loaded event 

EndDeferLoad - This call is meant to match a prior DeferLoad call, 
thereby cause Loaded event to be fired if there are no more pending EndDeferLoad 
calls. 

EnsureVisuals - Build the current Style's VisualTree 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Releases all resources held by the Visual object. Inherited from 

Visual. 

FindResource - Searches for a resource with the passed name and returns 

it 

Focus - Focuses the keyboard on this element. Liherited from 

UIElement. 

FrameworkElement - Default DependencyObject constructor 

GetAnimationBaseValue - If the dependency property is animated this 
method will give you the value as if it was not animated. Inherited from UIElement. 

GetAnimations - Retrieves an animation collection associated with a 
DependencylD on this element, hiherited from UIElement. 

GetAutomationProvider - Called by the Automation infrastructure to 
request a provider object to provide additional properties for this element. 

GetBinding - Returns the Binding for the specified property. 

GetHashCode - Serves as a hash fimction for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetLocalValueEnumerator - Create a local value enumerator for this 
instance Inherited from DependencyObject. 
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GetRoutedEventlDs - Get RoutedEventlDs with handlers Inherited from 

UIElement. 

GetType - Gets the Type of the current instance. Inherited from Object. 
GetValue - Retrieve the value of a property Inherited from 

DependencyObject. 

HitTestCore - HitTestCore implements precise hit testing against render 

contents Inherited from RetainedVisual. 

IDragDrop.OnDragEnter 

IDragDrop.OnDragLeave 

IDragDrop.OnDragOver 

IDragDrop.OnDrop 

IDragDrop.OnGiveFeedback 

IDragDrop.OnQueryContinueDrag 

ILogicalTreeNode-OnNewParent 

ILogicalTreeNode.C)nParentChanged 

InvalidateArrange - Invalidates the arrange state for the element. The 
element will be queued for an update layout that will occur asynchronously. 
MeasureCore will not be called unless InvalidateMeasure is also called - or that 
somethmg else caused the measure state to be invalidated. Inherited from UIElement. 

InvalidateMeasure - InvaUdates the measurement state for the element. 
This has the effect of also invalidating the arrange state for the element. The element 
will be queued for an update layout that will occur asynchronously, hiherited from 
UIElement. 

InvaUdateProperty - Invalidates a property Inherited from 

DependencyObj ect. 

InvalidateVisual - InvalidateVisual. hiherited from RetainedVisual. 

IRetainedRender.Render - hiherited from UIElement. 
IVisual.FindCommonVisualAncestor - Inherited from Visual. 
IVisualHitTest - Inherited from Visual. 
IVisuallsAncestorOf - Inherited from Visual. 
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IVisuaLIsDescendantOf - Inherited from Visual. 
rVisual.TransformFromAncestor - Inherited from Visual. 
IVisual.TransformFromDescendant - Inherited from Visual. 
rVisual.TransformFromVisual - Inherited from Visual. 
5 IVisual.TransformToAncestor - Inherited from Visual. 

IVisual.TransformToDescendant - Inherited from Visual. 
rVisual.TransformToVisual - Inherited from Visual. 
Measure Updates DesiredSize of the UIElement. Must typically be 
called by parents from theor MeasureCore, to form recursive update. This is first pass of 
1 0 layout update. Inherited from UIElement. 

MeasureChildHelper The helper method for a parent to call instead of 
Measure on a child during layout. Reads Width, Height, Min/Max Width, 
Min/MaxHeight from the child, uses reference size to resolve percent values and calls 
Measure method on a child with correct constraint. Aslo 'clamps' child's desired size 
1 5 using specified sizing properties. 

MeasureCore Measurement override. Implement your size-to-content 
logic here. Inherited from UIElement. 

MemberwiseClone Creates a shallow copy of the current Object. 
Inherited from Object. 
20 OnAccessKey The access key for this element was invoked. Base 

implementation sets focus to the element. Inherited from UIElement. 

OnChildDesiredSizeChanged Notification that is called by Measure of a 
child when it ends up with different desired size for the child. Inherited from 
UIElement. 

25 OnDelayedlnvalidate Inherited from DependencyObject in build. 

OnGotFocus An event announcing that the keyboard is focused on this 
element. Inherited from UIElement. 

OnGotMouseCapture An event reporting that this element got the mouse 
capture. Inherited from UIElement. 
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OnlsFocusedChanged An event reporting that the IsFocused property 

has changed. 

OnlsFocusWithinChanged An event reporting that the IsFocusWithin 

property changed. 

OnlsMouseCapturedChanged An event reporting that the 

IsMouseCaptured property changed. Liherited from UIElement. 

OnlsMouseDirectlyOverChanged An event reporting that the 

IsMouseDirectlyOver property has changed. 

OnlsMouseOverChanged An event reporting that the IsMouseOver 

property changed. 

OnKeyDown An event reporting a key was pressed. Inherited from 

UIElement. 

OnKeyUp An event reporting a key was released, hiherited from 

UIElement. 

OnLostFocus An event announcing that the keyboard is no longer 

focused Inherited from UIElement. 

OnLostMouseCapture An event reporting that this element lost the 

mouse capture. Inherited from UIElement. 

OnMouseEnter An event reporting the mouse entered this element. 

Inherited from UIElement. 

OnMouseLeave An event reporting the mouse left this element. 

Inherited from UIElement. 

OnMouseLeftButtonDown An event reporting the left mouse button was 

pressed. Inherited from UIElement. 

OnMouseLeftButtonUp An event reporting the left mouse button was 

released. Inherited from UIElement. 

OnMouseMove An event reporting a mouse move. Inherited from 

UIElement. 

OnMouseRightButtonDown An event reporting the right mouse button 
was pressed. Inherited from UIElement. 
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OnMouseRightButtonUp An event reporting the right mouse button was 

released. Inherited from UIElement. 

OnMouseWheel An event reporting a mouse wheel rotation, hiherited 

from UIElement. 

OnPreviewGotFocus An event announcing that the keyboard is focused 
on this element. Inherited from UIElement. 

OnPreviewKeyDown An event reporting a key was pressed, hiherited 

from UIElement. 

OnPreviewKeyUp An event reporting a key was released. Inherited 
from UIElement. 

OnPreviewLostFocus An event announcing that the keyboard is no 
longer focused Inherited from UIElement. 

OnPreviewMouseEnter When the mouse enters an element, set the 
cursor. We do this in a class handler, rather than overriding 

OnlsMouseDirectlyOverChanged, because ttiat is a virtual which can be overridden and 
not called. 

OnPreviewMouseLeave An event reporting the mouse left this element. 

Inherited from UIElement. 

OnPreviewMouseLeftButtonDown An event reporting the left mouse 

button was pressed. Inherited from UIElement. 

OnPreviewMouseLeftButtonUp An event reporting the left mouse 
button was released. Inherited from UIElement. 

OnPreviewMouseMove An event reporting a mouse move. Inherited 
from UIElement. 

OnPreviewMouseRightButtonDown An event reporting the right mouse 
button was pressed. Inherited from UIElement. 

OnPreviewMouseRightButtonUp An event reporting the right mouse 
button was released. Inherited from UIElement. 

OnPreviewMouseWheel An event reporting a mouse wheel rotation. 
Inherited from UIElement. 
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OnPreviewTextlnput An event announcing some text input. Inherited 
from UIElement. 

OnPropertylnvalidated Notification that a specified property has been 

invalidated 

OnRender Render callback. Inherited from UIElement. 
OnStyleChanged Style has changed 

OnTextlnput An event announcing some text input, hiherited from 

UIElement. 

RaiseCommand RaiseCommand hiherited from UIElement. 
RaiseEvent Raise the events specified by RoutedEventID hiherited from 

UIElement. 

RaiseQueryStatus RaiseQueryStatus hiherited from UIElement. 
ReadLocalValue Retrieve the local value of a property (if set) hiherited 

from DependencyObject. 

ReferenceEquals Determmes whether the specified Object instances are 

the same instance. Inherited fcom Object. 

ReleaseMouseCapture Releases the mouse capture, hiherited from 

UIElement. 

RemoveHandler Removes all instances of the specified routed event 
handler for this object instance Inherited from UIElement. 

RenderOpen RendeOpen opens the RetainedVisual for rendering. 

Inherited from RetainedVisual. 

SetAnimations Associates an AnimationCoUection with a 
DependencylD on this element, hiherited from UIElement. 

SetBinding Attaches a binding. 

SetContext Associates this UlContextObject with a UlContext. hiherited 

from UlContextObject. 

SetResourceReference Searches for a resource called name and sets up a 

resource refa-ence to it for the passed property. 
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SetValue Sets the local value of a property Inherited from 

DependencyObj ect. 

ToString Returns a String that represents the current Object. Inherited 

from Object. 

5 TraverseFocus Request to move the focus from this element to another 

element 

UpdateLayout Call this method to ensure that the whoel subtree of 
elements that includes this UIElement is properly updated. Inherited from UIElement. 

ValidateProperty Retrieve the value of a property (for use by native 
1 0 cache backed custom get accessors) Inherited from DependencyObj ect. 

ValidatePropertyCore Allows subclasses to participate in property value 

computation 

Property Attribute Description 

AnimationEffects - The collection of AnimationEffect attached to this 
1 5 element, friherited from UIElement. 

Clip - cup Property Inherited from UIElement. 
ClipToBounds - ClipToBounds Property friherited from UIElement. 
CommandLinks - CommandLinks Inherited from UIElement. 
ComputedSize - Returns the actual size of the element. Inherited from 

20 UIElement. 

ContentOwner - ContentOwner is the ItemsControl whose items produce 
the content for the current element. This property can only be set in the chrome template 
for an ItemsConfrol - it identifies the location in the template where the ItemsControl 
should place the UI generated for its items. 
25 Context - Returns the UlContext that this UlContextObject is associated 

with. Inherited from UlContextObject. 

Cursor - Cursor Property 

DataContext - Gets or sets the data context for an element. 
DependencyObjectType - Returns the DType that represents the CLR 
30 type of this instance Inherited from DependencyObject. 
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DesiredSize - Returns the size the element computed during the Measure 
pass. This is only valid if IsMeasureValid is true. Inherited fiom UIElement. 
FlowDirection - FlowDirection Property 
Focusable - Getter and Settor for Focusable Property 
5 ForwardCommandsTo - CommandLinks Inherited from UIElement. 

HasAnimations - Determines if any ammations are present on this 

element Inherited from UIElement. 

Height - Gets or sets the height of the element. 
HitTestBounds - HitBounds returns the hit region bounding box for the 
1 0 current visual, hiherited from Visual. 

ID - ID property. 

IsArrangeValid - Determines if the ComputedSize and position of child 

elements is valid. Inherited from UIElement. 

IsDisposed - Gets a value that indicates whether the system has disposed 

15 of the Visual. Inherited from Visual. 

IsEnabled - A property indicating if this element is enabled or not. 
IsFocused - A property indicating if the keyboard is focused on this 
element or not. Inherited from UIElement. 

IsFocusWithin - Indicates if Keyboard Focus is anywhere within in the 

20 subfree starting at the current instance 

IsLoaded - Read-only property that tells you if or not the current element 

has been loaded 

IsMeasureValid - Determines if the DesiredSize is valid. Inherited from 

UIElement. 

25 IsMouseCaptured - A property indicating if the mouse is captured to this 

element or not. Inherited from UIElement. 

IsMouseDirectlyOver - A property indicating if the mouse is over this 

element or not. hiherited from UIElement. 

IsMouseOver - A property indicating if the mouse is over this.element or 

30 not. 
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IsRequestingAnimationBaseValue - This property will return true while 
the class is calculating the animation base value requested by a call to 
GetAnimationBaseValueQ. Inherited from UIElement. 

IsTreeSeparator - Indicates if the current instance is at the root of a 

separate tree 

KeyboardActive - Gettor and Settor for KeyboardActive Property 

Margin - Margin Property 

MaxHeight - MaxHeight Property 

MaxWidth - MaxWidth Property 

MinHeight - MinHeight Property 

MinWidth - MinWidth Property 

Opacity - Opacity accessor Inherited from UIElement. 

Parent - Returns logical parent 

RenderBounds - This property is only used if the RetainedVisual 
implements RetainedRender. If not this property will throw an 
InvalidOperationException. The implementer must typically set this property to the 
bounds of the ink drawn by his Render ftinction in local coordinate space. Inherited 
from RetainedVisual. 

Resources - Current locally defined Resources 

Style - Style property 

Timeline - Timeline accessor. Inherited from UIElement. 
Visibility - Visibility accessor Inherited from UIElement. 
Width - Gets or sets the width of the element. 

class System.Windows.FrameworkElement : UIElement : RetainedVisual : Visual : 
DependencyObject : UlContextObject : Object 

Implements: IVisual IRetainedRender IlnputElement ICommandTarget 
IFrameworklnputElement ILogicalTreeNode IDragDrop ILoaded 
{ 

public Void ClearAllBindingsQ 
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public Void ClearBinding(DependencyProperty dp) 
public Object get_DataContextO 
public Binding GetBinding(DependencyProperty dp) 
public Void set_DataContext(Object value) 
public Binding SetBinding(DependencyProperty dp, Bind bind) 
public Binding SetBinding(DependencyProperty dp. String path) 
public Binding SetBinding(DependencyProperty dp, String path, BindType bindType) 
pubUc Binding SetBinding(DependencyProperty dp, String path. BindType bindType, 
ObjectRef source) 

public Binding SetBinding(DependencyProperty dp. String path, BindType bindType, 
ObjectRef source, UpdateType updateType) 

public Binding SetBinding(DependencyProperty dp, String path, 
BindType bindType, ObjectRef source, UpdateType updateType, IDataTransformer 
transformer) 

public Binding SetBinding(DependencyProperty dp, String path, 
BindType bindType, ObjectRef source, UpdateType updateType, IDataTransformer 

transformer, Culturehifo culture) 

public Binding SetBinding(DependencyProperty dp, String path, 
BindType bindType, ObjectRef source, UpdateType updateType, IDataTransformer 
transformer, Culturelnfo culture, BindFlags bindFlags) 

public static readonlyDependencyProperty DataContextProperty 

} 

Templating instance representation 
Method Description 

AliasProperty - Set up a binding between a template child and the styled 

container 

AppendChild - Add a factory child to this factory 

Createlnstance - Create an instance of the specified type 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 
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Finalize - Allows an Object to attempt to free resources and perfonn 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

FrameworkElementFactory - Construction 

GetHashCode - Serves as a hash function for a particular type, suitable 
for use in hashing algorithms and data structures like a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

SetBinding - Creates an initial binding in the factory's template children. 

SetValue - Simple value set on template child 

ToString - Returns a String that represents the current Object, hiherited 

from Object. 

Property Description 

FirstChild - First child factory 

IsSealed - FrameworkElementFactory mutabiUty state 

NextSibling - Next sibling factory 

Parent - Parent factory 

StylelD - Style identifier 

Type - Type of object that the factory will produce 

class System. Windows.FrameworkElementFactory : Object 
{ 

public Void SetBinding(DependencyProperty dp, Bind bind) 

} 
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class System.Windows.FrameworkPropertyMetadata : PropertyMetadata : Object 
{ 

public Boolean get_DatabindableO 

public Void set_Databindable(Booleaii value) 

} 

enum sealed System.Windows.MetadataFlags : Enum : ValueType : Object 
Implements: IComparable IFonnattable IConvertible 

{ 

public static MetadataFlags NoDatabind 

} 

abstract interface System. Windows.IApplyValue 
{ 

public virtual Void Apply(DependencyObject e, DependencyProperty dp) 

} 

An abstract class, used as the base class for several other provided 
"Avalon" classes that manage a view of a data collection. 

CoUectionChanged - Occurs when the collection view changes. This 
could mean that items were added or removed in the collection, or that a new sort or 

filter was applied to this view. 

ProtectedCurrentChanged - A protected event. In derived classes, this 

event occurs after changing the position of the record pointer. 

ProtectedCurrentChanging - A protected event. In derived classes, this 
event occurs before a change in currency. If necessary, handlers of the event can cancel 
the change. 

Method Description 

ChangedCurrent - Raises the implemented CurrentChanged event of the 

object. 
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CoUectionView - Initializes a new instance of a CoUectionView derived 
class. This constructor is protected in the base CoUectionView class. 

Contains - Determines whether a given data item belongs to this 

collection view. 

Containsltem - Determines whether a given data item belongs to this 

collection view or the unfiltered collection. 

Equals - Determines whether two Object instances are equal. Inherited 

from Object. 

Finalize - Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetEnumerator - Returns an enumerator that can iterate through the 
collection view. 

GetHashCode - Serves as a hash ftinction for a particular type, suitable 
for use in hashing algorithms and data structures Uke a hash table. Inherited from 
Object. 

GetType - Gets the Type of the current instance. Inherited from Object. 
IndexOf - Returns the index where the given data item belongs in the 
collection, or -1 if the index of that item is unknown. 

MemberwiseClone - Creates a shallow copy of the current Object. 

Inherited from Object. 

OKToChangeCurrent - Determines whether it is allowable to change the 

position of the current record pointer. 

OnCoUectionChanged - Implement this method to handle 
CollectionChanged events in the data collection that underlies the collection view. 

ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

Refresh - Refreshes the view. Reapplies any current sort or filter 
conditions, as set by various properties that declare sort or filter criteria. 
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ToString - Returns a String that represents the current Object. 

fiom Object. 



abstract class System.ComponentModel.CoUectionView : Object Implements: 
5 Enumerable ICoUectionChange 
{ 

protected Void ChangedCurrentQ 
public virtual Boolean Contains(Object item) 
public virtual Boolean ContainsItem(Object item) 
1 0 public virtual Boolean get_CanFilterO 
public virtual Boolean get_CanSortO 
public ICollection get_CollectionO 
public virtual IComparer get_ComparerO 
public virtual Int32 get_CountO 
1 5 public virtual ICurrentltem get_CurrentItemO 
public virtual String get_FilterO 
public virtual SortDescription[] get_SortO 
public Object get_ViewManagerDataO 
public virtual lEnumerator GetEnumeratorQ 
20 pubUc virtual Int32 IndexOf(Object item) 

protected Boolean OKToChangeCurrentQ 

protected virtual Void OnCollectionChanged(Object sender, 
CoUectionChangeEventArgs args) 

public virtual Void RefreshQ 
25 public virtual Void set_Filter(String value) 

public virtual Void set_Sort(SortDescription[] value) 

public Void set_ViewManagerData(Object value) 

} 

Represents the method that handles the CurrentChanged event raised by 
30 collection views, or any class implementing the ICurrentltem interface. 
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Parameters 

sender System.Object. View that is proposing to change current item, 
args System.EventArgs. Event arguments. 
Return Value System. Void. 

class sealed System.ComponentModel.CurrentChangedEventHandler : 
MulticastDelegate : Delegate : Object Implements: ICloneable ISerializable 

{ 

pubUc virtual lAsyncResult BeginInvoke(Object sender, EventArgs args, 
AsyncCallback callback, Object object) 
public virtual Void EndInvoke(IAsyncResult result) 
public virtual Void Invoke(Object sender, EventArgs args) 

} 

Represents the method that handles the CurrentChanging event raised by 
collection view classes, or any class implementing the ICurrentltem interface. 
Parameters 

sender - System.Object. The collection view Object that is changing 

currency. This will be an instance of CoUectionView a derived class, or a class 

implementing ICurrentltem. 

args - System.ComponentModel.CancelEventArgs. Arguments of the 

event, as an instance of CancelEventArgs. 

Return Value System. Void. 

This event is invoked immediately before the current record pointer 
moves in this view. The Cancel property in the event arguments can be used to cancel 
the proposed move, and this convention should be respected by the currency logic in 
custom collection views. See ProtectedCurrentChanging for an example. 
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CoUectionView is an abstract class. The event might be more properly 
understood by looking at actual derivations of the class, such as ListCoUectionView and 
ArrayListCoUectionView. In these classes the event does not include the "Protected" 
prefix. 

5 

class sealed System.ComponentModel.CurrentChangingEventHandler : 
MuWcastDelegate : Delegate : Object Implements: ICloneable ISerializable 
{ 

public virtual lAsyncResult BeginInvoke(Object sender, CancelEventArgs args, 
10 AsyncCallback callback, Object object) 

public virtual Void EndInvoke(IAsyncResult result) 

pubUc virtual Void Invoke(Object sender, CancelEventArgs args) 

} 
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Enables notifications that items within a collection have changed: an 
item has been added, removed, or the entire collection has been refi-eshed. 
Event Description 

CollectionChanged - Occurs if the collection has changed its content. 
Arguments of the event specify the change that has taken place. 

This interface is implemented by the ArrayListDataCollection data 

collection class. 



abstract interface System.ComponentModel.ICollectionChange 

{ 

25 } 

An interface used to create collection view factory classes, which m turn 
create new CoUectionView derived objects. 
Method Description 

CreateView - Creates a new view on the collection that implements this 
30 interface. Normally, this method is only called by a view manager, not by user code. 
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Normally, user code does not call methods on this interface. The 
5 common way to obtain a view over a collection is to call GetView. 



abstract interface System.ComponentModel.ICoUectionViewFactory 
{ 

public virtual CoUectionView CreateViewQ 

10 } 

Maintains the concept of the current record pointer in a collection view. 
Event Description 

CurrentChanged - Occurs immediately after changing the position of the 

1 5 current record pointer within the collection view. 

CurrentChanging - Occurs immediately before changing the position of 
the current record pointer within the collection view. Handlers to the event should have 
the opportunity to cancel the position move by using the Cancel property of the returned 
arguments class to cancel the move. 
20 Method Description 

MoveFirst - Moves the record pointer to the first record in the collection 

view. 

MoveLast - Moves the record pointer to the last record in the collection 

view. 

25 MoveNext - Moves the record pointer to the next record in the collection 



view. 



MovePrevious - Moves the record pointer to the previous record in the 



collection view. 

MoveTo - Moves the record pointer to the specified record in the 
30 collection view. 
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Property Description 

BOF - Gets the Boolean value that declares whether the record pointer is 
at or before the beginning of the collection array. 

Current - Gets the current record located at the current record pointer 

position. 

EOF - Gets a Boolean value that declares whether the record pointer is at 
or beyond the end of the collection array. 



Remarks 

ArrayListCoUectionView implements this interface indirectly, as do 

several other provided collection view classes. 

To access methods of ICurrentltem in collection views, get the 
Currentltem object in the view, lliis object supports ICurrentltem and thus enables 
changing the current record position. 

By choosing to not implement this interface, very simple collection 
views can choose not to support currency, but this is not recommended. 

How Do I Navigate Through the Objects in a Data Collection View? 

You can navigate through the objects in a data collection view by using 
the methods provided in view classes that inherit the ICurrentltem interface. Although 
the methods and properties involved are not direct members of the view classes, you 
can call these methods by returning the Currentltem object and calling the various 
ICurrentltem collection navigation methods on it. In most cases, implementations of 
collection views derive from CoUectionView and inherit from ICurrentltem. There are 
several methods defined by ICurrentltem that are used for navigating the objects in the 
collection. 



MoveFirst 
MoveLast 
MoveNext 
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MovePrevious 
MoveTo 

MoveFirst and MoveLast take you to the first or last objects in the 
collection, respectively. MoveNext and MovePrevious take you to the next or previous 

5 objects in the collection, relative to the Current object. MoveTo accepts an object 
argument and moves the current record pointer to that object's record if it could be 
found. In addition to attempting the desired move, these methods return Boolean values 
that inform you whether the record pointer is now on an item that exists in the current 
view (this distinction comes into play if you are viewing a collection with a filter 

10 applied). 

In this C# example, the same fimction handles button clicks from either a 
Previous or Next button. MyCoUectionView is a view that is an instance of 
CoUectionView. This is the base view class that implements the ICurrentltem interface. 
1 5 Most common view operations can be handled with this base class, rather than choosing 
to cast the initially returned view to the more speciaUzed view classes 
ListCollectionView, BindingListCoUectionView, or ArrayListCoUectionView . 



pubHc void OnButton(Object sender, ClickEventArgs args) 
20 { 

Button b = sender as Button; 
switch(b.ID) 

{ 

case "Previous": 

25 MyCollectionView.CurrentItem.MovePreviousO; 

if(!MyCollectionView.CurrentItem.BOF) 

{ 

FeedbackText.Text = ""; 

o = MyCollectionView.CurrentItem.Current as Order; 
30 myListBox.SelectedIndex = MyCollectionView.IndexOf(o); 
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} 

else 

{ 

MyCollectionView.CurrentItem.MoveFirstO; 
FeedbackText.Text = "At first record"; 

} 

break; 
case "Next": 
MyCoUectionView.Currentltem.MoveNextO; 
if(!MyCollectionView.CurrentItem.EOF) 

{ 

FeedbackText.Text = ""; 

o = MyCoUectionView.Currentltem.Current as Order; 
myListBox.Selectedlndex = MyCollectionView.IndexOf(o); 

} 

else 
{ 

MyCollectionView.CurrentItem,MoveLastO; 
FeedbackText.Text = "At last record"; 

} 

break; 

} 

} 

abstract interface System.ComponentModel.ICurrentItem 

public virtual Boolean get_BOF0 
public virtual Object get_CurrentO 
public virtual Boolean get_EOF() 
public virtual Boolean MoveFirstQ 
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public virtual Boolean MoveLastQ 
public virtual Boolean MoveNextQ 
public virtual Boolean MovePreviousQ 
public virtual Boolean MoveTo(Object item) 

} 

Create a One-Way Binding to a Dynamically Updated Data Source 
Classes that implement this interface can update the bound target 
property whenever the source property changes. 



Event Description 

PropertyChanged - Occurs whenever a property of a data item class 



changes. 



Events 



How Do I Implanent Property Change Notification? 

This example shows how to provide for property change notification in 
your data items by implementing the IPropertyChange interface. 

You can bind user interface (UI) presentation elements to data items with 
One-Time binding. The UI will then reflect the initial value of the data item but will not 
automatically reflect changes in that underlying data item. " Avalon" also supports One- 
Way and Two-way binding. In One-Way binding the target of the binding responds 
automatically to changes in a source data item. To bind so that changes in your source 
data item are automatically reflected in your binding target, you must typically add code 
to support property change notifications. You do this by deriving your source data item 
class fi-om IPropertyChange and then declaring the PropertyChanged event as a 
PropertyChangedEventHandler delegate. Declaring the event is how you implement the 
IPropertyChange interface on your data item. Within the data item you then define your 
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own notification method containing program logic that eventually raises the event by 
calling back through its event handler. You typically call your notification method 
within the set method of your data item property when you determine that the data value 
of the property has changed. The set method of your property is called when the 
property is assigned a value by outside users of your data item. 

In the following code, the data item is declared as a NumberListltem 
class that derives ftom IPropertyChange. Though other properties of the data item could 
be exposed, in this example one property, NLValue, is exposed as sufficient for this 
class. In compliance with the IPropertyChange interface contract, the class also exposes 
the public event PropertyChanged. A private NotifyPropertyChanged method is used 
internally as the method to call for notification. It accepts the name of an exposed 
property as a string, in this case NLValue. Within the notification method the event 
condition is raised by calling the event handler through the declared event. Of course, as 
a precaution against a null reference exception, the callback is only attempted if the 
event has been assigned a non-null reference to an event handler. That assigmnent is 
normally done by the system ahead of time when objects of this data item class are 
instantiated. The callback invocation of the event handler also accepts the name of the 
property, but only if that name is enveloped within a PropertyChangedEventArgs object 
that is created anew for this purpose. To complete the notification support, within the 
set method of the property a call to the private NotifyPropertyChanged method is done 
when a change in the value of the property is detected. Both the value assigmnent and 
the notification are done only if the new value passed to the set method is different than 
the current value of the property, _NLValue. 



For C#, here is the declaration of the data item class. 

public class NumberListltem : IPropertyChange 
{ 

private int _NLValue = 0; 
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static NumberListltemO 

{ 

} 

public int NLValue 
{ 

get 
{ 

return JSTLValue; 

} 

set 

{ 

if (_NLValue != value) 
{ 

NLValue = value; 

NotifyPropertyChanged("NLValue"); 

} 

} 

} 

// The following variable and method provide the support for 
// handling property change notifications, 
public event PropertyChangedEventHandler PropertyChanged; 
private void NotifyPropertyChanged(String info) 

{ 

if (PropertyChanged !=null) 

PropertyChanged(this, new PropertyChangedEventArgs(info)); 

} 

} 
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For Microsoft® Visual Basic® .NET, here is the declaration of the data 

item class. 



Public Class NumberListltem 
Implements IPropertyChange 

Private JSfLValue As Integer = 0 

Shared Sub New() 

End Sub "New 

' The following event and method provide the support for 
' handling property change notifications. 

Public Event PropertyChanged As PropertyChangedEventHandler 
Implements IPropertyChange.PropertyChanged 

Private Sub NotifyPropertyChanged(ByVal info As String) 
RaiseEvent PropertyChanged(Me, New 
PropertyChangedEventArgs(info)) 

End Sub "NotifyPropertyChanged 

Public Property NLValueQ As Integer 
Get 

Return _NLValue 
End Get 

Set 

If _NLValue o value Then 
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_NLValue = value 
NotifyPropertyChangedC'NLValue") 

End If 
End Set 
End Property 

End Class "NumberListltem 

Create a One-Way Binding to a Dynamically Updated Data Source 

This example shows how binding to a data object where 
PropertyChanged is implemented with a one-way bmding will refresh the bound 
properties in a control whenever the data changes. 

For most bindings, you want to use either a one-way or two-way binding, 
so that the destination element reflects data changes in the bound source property. If 
you want these updates to happen automatically as intended, it is an absolute 
requirement that the individual data properties each raise the PropertyChanged event 
upon an internal change in their value, and, therefore, either the overall data class or the 
individual items in a data collection must typically implement IPropertyChange. 

The C# example shown here is the complete code for a data class and 
includes an internal timer loop that produces real-time changes in the underlying data 
properties. This scenario is similar to implementing a "stock ticker" in a Web page, 
where the application is consuming data that could change at any time, but not 
necessarily writing back to the soitfce. 
using System; 

using System.ComponentModel; 
using System.Windows; 
using System. Windows.Controls; 
using System.ComponentModel; 
using System. Windows.Data; 



namespace WCPSample { 
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public class myDataCollection: ArrayListDataCoUection 
{ 

public myDataCollection _changeThis; 
public myData iteml = new myData("Ichiro 
Bobblehead",(decimal)24.95); 

public myData item2 = new myData("Edgar Toy Duck",(decimal) 

16.05); 

public myData item3 = new myData("Jefr Cirillo Golden 

Sombero", (decimal) 0.99); 

public myDataCollectionO:baseO 

{ 

Add(iteml); 
Add(item2); 
Add(item3); 
CreateTimerO; 

} 

private void CreateTimerQ 
{ 

System-Timers.Timer Timerl = new System.Timers.TimerQ; 
Timerl .Enabled = true; 
Timerl .Interval = 10000; 
Timerl .Elapsed += new 
System.Timers.ElapsedEventHandler(Timerl_Elapsed); 

} 

private void Timerl_Elapsed(object sender, 
System.Timers.ElapsedEventArgs e) 
{ 

iteml .BidItemPrice+= (decimal) 1.10; 
item2.BidItemPrice += (decimal) 0.40; 



} 

} 

public class myData: IPropertyChange 
{ 

private string _biditemname = "Unset"; 
private decimal _biditemprice = (decimal) 0.0; 

public myData(string NewBidltemName, decimal 
NewBidltemPrice) { 

J)iditemname = NewBidltemName; 
_biditemprice = NewBidltemPrice; 

} 

public string BidltemName 

{ 

get 
{ 

return biditemname; 

} 

set 

{ 

if(_biditanname.Equals(value) = false) 
{ 

biditemname = value; 

//Call Notify PropertyChanged whenever the property 

updated 

NotifyPropertyChangedC'BidltemName"); 

} 

} 

} 
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public decimal BidltemPrice 
{ 

get 
{ 

return _biditemprice; 

} 

set 

{ 

ifi[_biditemprice.Eqiials(value) = false) 
{ 

biditemprice = value; 

//Call Notify PropertyChanged whenever the property is 

updated 

NotifyPropertyChangedC'BidltemPrice"); 

} 

} 

} 

//Declare event 

pubUc event PropertyChangedEventHandler PropertyChanged; 
//NotifyPropertyChanged event handler to update property value 

binding 

private void NotifyFropertyChanged(string propName) 
{ 

if (PropertyChanged !=null) 
{ 

PropertyChanged(this, new 
PropertyChangedEventArgs(propName)); 

} 

} 

} 
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} 



abstract interface System.ComponentModel.IPropertyChange 

{ 

5 } 

Describes a sort qualifier that is used to sort items in a collection when 
creating a view. An array of these qualifier descriptions is used to set the Sort property 
of a collection view. 

Method Description 

10 Equals - Indicates whether this instance and a specified object are equal. 

hiherited firom ValueType. 

Finalize - Allows an Object to attempt to fi-ee resources and perform 
other cleanup operations before the Object is reclaimed by garbage collection. Inherited 
firom Object. 

15 GetHashCode - Returns the hash code for this instance, hiherited firom 

ValueType. 

GetType - Gets the Type of the current instance. Inherited from Object. 
MemberwiseClone - Creates a shallow copy of the current Object. 
Inherited from Object. 

20 ReferenceEquals - Determines whether the specified Object instances 

are the same instance. Inherited from Object. 

SortDescription - Initializes a new instance of a SortDescription 

structure. 

ToString - Returns the fiilly qualified type name of this instance. 
25 Inherited from ValueType, 

Property Description 

Direction - Gets the sort direction value declared in this sort direction 

item. 

Empty - Represents an empty sort description array. This method is 
30 intended to be called statically. 
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PropertyName - Gets the property name declared by this sort direction 
item. This property should be exposed as public in the underlying collection. 

How Do I Sort Data? 

This example describes how to sort data in a data collection view. A data 
collection is a group of data of type lEnumerable, where members of the collection 
hnplement IPropertyChange and the collection itself implements ICoUectionChange. A 
data collection view is one possible view of that collection, where additional conditions 
such as sorting and filtering can be appUed to the collection, but these views leave the 
underlying collection unchanged. - 

To sort the data, set the Sort property on any view class derived from 
CoUectionView. This property is set to an array of SortDescription structures. Each 
structure describes one property of the data that should be the property sorted upon, and 
the sort direction. Items in the array of these structures are handled sequentially when 
the sort is performed. 

The following C# example sorts the data in ascending order. Each 
member of the collection is an Order object and is sorted by the sequence of the order 
property in the data. MyALCoUectionView is an ArrayListCoUectionView object 
obtained fi-om the collection, and sdA is the array of sort descriptions. 

sdA[0] = new 
SortDescription("order",ListSortDirection.Ascending); 

MyALCoUectionView.Sort = sdA; 

You also call Refi-esh on the view to have the sort order take effect. 
MyALCoUectionView.RefreshQ; 

Note: Alternatively, if you are using one of the collection types provided 
by "Avalon", you can use the custom sort methods on its matching collection view. For 
instance, if your data collection is based on ListCoUectionView, you can use 
ListCoUectionView.CustomSort. This approach is not discussed here. 
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struct sealed System.ComponentModelSortDescription : ValueType : Object 
{ 

public ListSortDirection get_Direction() 
5 public static SortDescription[] get_Empty() 
public String get_PropertyNameO 

} 

Thus, as described, the present invention provides a mechanism for 
associating a source data value with a target property in such a manner that changes in 
10 the coding of the user interface and the logic may be de-coupled. Thus, the present 
invention allows developers to easily modify and enhance the user interface without 
requiring them to modify the underlying logic of the application. 

The above specification, examples and data provide a complete 
description of the manufacture and use of the composition of the invention. Since many 
15 embodiments of the invention can be made without departing from the spirit and scope 
of the invention, the invention resides in the claims hereinafter appended. 
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